Guides - Using Cyberduck with Object Storage

S3-compatible Linode Object Storage makes it easy and more affordable to manage unstructured data such as content assets, as well as sophisticated and data-intensive storage challenges around artificial intelligence and machine learning.

Create a Linode account to try this guide with a $100 credit.
This credit will be applied to any valid services used during your first 60 days.

Cyberduck is a desktop application that facilitates file transfer over FTP, SFTP, and a number of other protocols, including S3.

Install and Configure Cyberduck

  1. Download Cyberduck by visiting their website.

  2. After you have Cyberduck installed, open the program and click Open Connection.

  3. At the top of the Open Connection dialog, select Amazon S3 from the dropdown menu.

  4. For the Server address, enter either if the bucket is in the Newark data center, if the bucket is in the Frankfurt data center, or if the bucket is in the Singapore data center.

  5. Enter the access key in the Access Key ID field, and the secret key in the Secret Access Key field.

  6. Click Connect.

You are now ready to create a bucket in Object Storage.

Create a Bucket with Cyberduck

To create a bucket in Cyberduck:

  1. Right click within the window frame, or click Action, then click New Folder:

    Right click or click ‘Action’, then click ‘New Folder’

  2. Enter the bucket’s label and then click Create. See the Bucket Name section for rules on naming the bucket.

  3. To delete the bucket using Cyberduck, right click the bucket and select Delete.

Upload, Download, and Delete an Object with Cyberduck

  1. To upload objects with Cyberduck, you can simply drag and drop the object, or directory of objects, to the bucket you’d like to upload them to, and Cyberduck does the rest. Alternatively, you can click the Action button and select Upload from the menu:

    Click the ‘Action’ button to use the file upload dialog.

    Uploading or renaming objects using non-standard special characters and unusual ASCII/Unicode characters may cause issues.
  2. To make the objects publicly accessible, meaning that you can access them from the object’s URL, you need to set the proper READ permissions. Right click the object and select Info.

  3. Click the Permissions tab.

  4. Click the gear icon at the bottom of the window and select Everyone.

    Open the file permissions prompt by right clicking the file and selecting.

  5. A new entry for Everyone appears in the Access Control List. Next to Everyone, under Permissions column heading, select READ from the drop down menu.

    Set the permissions for ‘Everyone’ to READ.

    The object is now accessible through the internet, at the URL, where my-example-bucket is the label of the bucket, is the cluster where the bucket is hosted, and example.txt is the name of the object.

  6. To download an object, right click the object and select Download, or click Download As if you’d like to specify the location of the download.

  7. To delete an object, right click the object name and select Delete.

Create a Static Site with Cyberduck

To create a static site from the bucket:

  1. Select a bucket, then right click the bucket or select the Action button at the top of the menu.

  2. Click Info, and then select the Distribution (CDN) tab.

  3. Check the box that reads Enable Website Configuration (HTTP) Distribution:

    Check the box labeled ‘Enable Website Configuration (HTTP) Distribution’

  4. You need to separately upload the index.html and 404.html files (or however you have named the index and error pages) to the bucket. Follow the instructions from the Upload, Download, and Delete an Object with Cyberduck section to upload these files.

  5. The static site is accessed from a different URL than the generic URL for the Object Storage bucket. Static sites are available at the website-us-east-1 subdomain for the Newark data center, the website-eu-central-1 subdomain for the Frankfurt data center, and the website-ap-south-1 subdomain for the Singapore data center. Using my-example-bucket as an example, you would navigate to either:

    • or
    • or

    For more information on hosting a static website with Object Storage, read the Host a Static Site using Linode Object Storage guide.

This page was originally published on

Your Feedback Is Important

Let us know if this guide made it easy to get the answer you needed.