Cyberduck Quickstart

Learn how to use Cyberduck with Rabata.io for managing your object storage through a user-friendly interface.

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.

Prerequisites

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:

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:

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:

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

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.eu-west-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