Cyberduck

Last update: October 05 2026Open in Markdown

Cyberduck is a file manager that supports FTP, OpenStack Swift, and Amazon S3 protocols. You can work with Cyberduck via a graphical or command-line client. The graphical client is available on Windows and macOS. The command-line client is available on Windows, Linux, and macOS.

Configure Cyberduck

1. Configure S3 access.
2. Configure the client.

1. Configure S3 access

Access can be configured by the Account Owner or a user with the iam.admin role.

1. Create a service user with a role with access to S3. If you use a service user with the s3.user, object_storage_user or s3.bucket.user role, the bucket must have a configured access policy and its rules must allow access to this user.
2. Issue an S3 key to the user.

2. Configure the client

Graphical client

Windows

1. Install Cyberduck.
2. Open Cyberduck.
3. Click Open Connection.
4. In the top field, open the list and select More Options.
5. In the Profiles section, select the Selectel S3 Cloud Storage profile. To work with the profile, the bucket must have virtual-hosted addressing enabled.
6. Restart Cyberduck.
7. Click Open Connection.
8. In the top field, open the list and select Selectel S3 Cloud Storage.
9. In the Access Key field, paste the Access key value from the S3 key of the user for whom you configured access in step 1.
10. In the Secret Key field, paste the Secret key value from the S3 key of the user for whom you configured access in step 1.
11. Click Connect.

macOS

1. Install Cyberduck.
2. Open Cyberduck.
3. Click Open Connection.
4. In the top field, open the list and select More Options.
5. On the Profiles tab, select the Selectel S3 Cloud Storage profile. To work with the profile, the bucket must have virtual-hosted addressing enabled.
6. Restart Cyberduck.
7. Click Open Connection.
8. In the top field, open the list and select Selectel S3 Cloud Storage.
9. In the Access Key field, paste the Access key value from the S3 key of the user for whom you configured access in step 1.
10. In the Secret Key field, paste the Secret key value from the S3 key of the user for whom you configured access in step 1.
11. Click Connect.

Console client

For more information about working with the command-line client, see the Command Line Interface (CLI) guide in the Cyberduck documentation.

Windows

The command-line version of Cyberduck for Windows is installed using the Chocolatey package manager.

1. Open the command line as an administrator.

2. Install the Chocolatey package manager.

3. Install Cyberduck:

   choco install duck

4. To install all packages, enter A and press Enter.

5. Download the Selectel profile file.

6. Upload the profile file to the %AppData%\Cyberduck\Profiles folder.

Linux

1. Open the terminal.

2. Add the duck repository:

   sudo echo 'deb https://s3.amazonaws.com/repo.deb.cyberduck.io nightly main' >> /etc/apt/sources.list.d/cyberduck.list
   sudo echo 'deb https://s3.amazonaws.com/repo.deb.cyberduck.io stable main' >> /etc/apt/sources.list.d/cyberduck.list

3. Add the GPG key:

   sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys FE7097963FEFBE72

4. Update the repository:

   sudo apt-get update

5. Install Cyberduck CLI:

   sudo apt-get install duck

6. Download the Selectel profile:

   wget https://static.selectel.ru/kb/selectel-s3-cloud-storage.cyberduckprofile

7. Create the profiles directory:

   mkdir -p ~/.duck/profiles

8. Move the downloaded Selectel profile to the profiles directory:

   mv 'selectel-storage.cyberduckprofile' ~/.duck/profiles/

macOS

The command-line version of Cyberduck for macOS is installed using the Homebrew package manager.

1. Open the terminal.

2. Install Cyberduck:

   brew install duck

3. Download the Selectel profile:

   wget https://static.selectel.ru/kb/selectel-s3-cloud-storage.cyberduckprofile

4. Create the profiles directory:

   mkdir -p ~/Library/Group Containers/G69SCX94XU.duck/Library/Application Support/duck/Profiles

5. Move the downloaded Selectel profile to the profiles directory:

   mv 'selectel-storage.cyberduckprofile' ~/Library/Group Containers/G69SCX94XU.duck/Library/Application Support/duck/Profiles

Command format for the console client

To work via the console client, use commands of the following form (with Path-Style addressing):

duck --region <pool> --username <access_key> --password <secret_key> --<command> s3://<s3_domain>/<bucket_name>

Specify:

• <pool> — pool where S3 is located;
• <access_key> — value of the Access key field from the S3 key;
• <secret_key> — value of the Secret key field from the S3 key;
• <command> — Cyberduck command; you can see some commands in the CLI documentation;
• <s3_domain> — S3 API domain. The domain depends on the pool where S3 is located;
• <bucket_name> — bucket name.

Get a link to an object

You can get a link to an object in a public or private bucket using a presigned URL. For more information about Presigned URLs, see the Sharing objects with presigned URLs guide in the AWS documentation.

1. Open the Cyberduck graphical client.
2. In the bucket object list, right-click the object and select Copy URL.
3. Select one of the Presigned URL options depending on the desired link expiration time: an hour, a day, or a week.