Cyberduck Quickstart

Overview

Cyberduck is a cloud storage browser for Mac and Windows with support for FTP, SFTP, WebDAV, Amazon S3, and many other protocols. This guide will walk you through configuring Cyberduck to work with Rabata.io's S3 storage.

View markdown

Prerequisites

  • A Rabata.io account with active access keys
  • Cyberduck installed on your system (macOS or Windows)
  • At least one bucket created in your Rabata.io account

Installation

Download Cyberduck

Download the latest version of Cyberduck for your operating system:

Install Cyberduck

Follow the standard installation process for your operating system:

macOS

  1. Open the downloaded .zip file
  2. Drag Cyberduck to your Applications folder
  3. Launch Cyberduck from Applications

Windows

  1. Run the downloaded installer
  2. Follow the installation wizard
  3. Launch Cyberduck from the Start menu

Configuration

Step 1: Open Connection Dialog

  1. Launch Cyberduck
  2. Click the Open Connection button in the toolbar (or press Cmd+O on macOS / Ctrl+O on Windows)

Step 2: Select Protocol

  1. In the dropdown menu at the top, select Amazon S3
Cyberduck Protocol Selection

Step 3: Configure Connection Settings

Enter the following information:

  • Server: s3.us-east-1.rabata.io
  • Port: 443 (default)
  • Access Key ID: Your Rabata.io access key ID
  • Secret Access Key: Your Rabata.io secret access key
Cyberduck Dashboard Cyberduck Connection Dialog

Step 4: Connect

Click Connect to establish the connection to Rabata.io.

Step 5: Creating a Bookmark

  1. Choose Bookmark → New Bookmark from the menu (or press Cmd+B on macOS / Ctrl+B on Windows)
  2. Select Amazon S3 as the protocol

Detail will be filled with your existing connection settings when you adding new bookmark:

  • Nickname: Give your bookmark a memorable name (e.g., "Rabata.io Storage")
  • Server: s3.us-east-1.rabata.io
  • Access Key ID: Your Rabata.io access key ID
  • Path: (Optional) Enter /bucket-name to open a specific bucket by default
Cyberduck Bookmark Configuration

Step 6: Save Credentials

  1. Close the bookmark window
  2. When prompted, enter your Secret Access Key
  3. Check Save password to store it in your system keychain (recommended for convenience)

Working with Buckets and Objects

Viewing Buckets

Once connected, you'll see a list of all your Rabata.io buckets. The interface shows:

  • Bucket names
  • Creation dates
  • Region information (currently us-east-1)

Creating a New Bucket

  1. Right-click in the bucket list
  2. Select New Folder (buckets appear as folders in Cyberduck)
  3. Enter a unique bucket name following S3 naming conventions:
    • 3-63 characters long
    • Only lowercase letters, numbers, and hyphens
    • Must start and end with a letter or number
  4. Click Create

Uploading Files

There are several ways to upload files to your Rabata.io buckets:

Drag and Drop

  1. Navigate to the desired bucket
  2. Drag files from your file explorer directly into Cyberduck
  3. The upload will start automatically

Upload Button

  1. Navigate to the desired bucket
  2. Click the Upload button in the toolbar
  3. Select files to upload
  4. Click Choose

Context Menu

  1. Right-click in the bucket
  2. Select Upload...
  3. Choose your files

Managing Objects

Downloading Files

  • Single file: Double-click to download to your default download location
  • Multiple files: Select files and click the Download button
  • Custom location: Right-click and select Download To...

Deleting Objects

  1. Select the objects you want to delete
  2. Press Delete key or right-click and select Delete
  3. Confirm the deletion

Renaming Objects

  1. Select the object
  2. Press Enter or right-click and select Rename
  3. Enter the new name
  4. Press Enter to confirm

Setting Permissions

Object ACL

  1. Right-click on an object
  2. Select Info
  3. Navigate to the Permissions tab
  4. Configure access control:
    • Private: Only you can access
    • Public Read: Anyone can read the object
    • Public Read/Write: Anyone can read and write (not recommended)
Cyberduck ACL Permissions Screenshot

Generating Shareable URLs

  1. Right-click on an object
  2. Select Copy URL to get the direct URL
  3. For temporary access, select Copy HTTP URL with expiration
Cyberduck Copy URL Screenshot

Troubleshooting

Connection Issues

If you cannot connect to Rabata.io:

  1. Verify credentials: Ensure your Access Key ID and Secret Access Key are correct
  2. Check server address: Confirm you're using exactly s3.us-east-1.rabata.io
  3. Test network: Ensure you have internet connectivity
  4. Firewall settings: Make sure port 443 (HTTPS) is not blocked

SSL/TLS Certificate Errors

If you encounter certificate warnings:

  1. Ensure you're using the latest version of Cyberduck
  2. Check your system date and time are correct
  3. If the issue persists, contact Rabata.io support

Performance Optimization

For better performance:

  1. Enable parallel transfers: Preferences → Transfers → Use concurrent connections
  2. Adjust connection limit: Increase the number of concurrent connections (default is 5)
  3. Use compression: Enable for text-based files in Preferences → Transfers

Access Denied Errors

If you receive permission errors:

  1. Verify your access keys have the necessary permissions
  2. Check bucket policies and ACLs
  3. Ensure you're accessing the correct bucket/region

Next Steps

Additional Resources