Cyberduck

Last update: May 27 2025

Cyberduck

Cyberduck — is a file manager that supports FTP, OpenStack Swift and Amazon S3 protocols.Cyberduck can be operated via a graphical or console client.

Customize Cyberduck⁠

1. Configure access.
2. Customize the client.

1. Set up access⁠

Access can be configured by a user with the Account Owner or User Administrator role.

1. Create a service user с role with access to the object store.If you are using a user with the Object Storage User role, the container must have a configured access policy.
2. Issue an S3 key to the user.

2. Configure the client⁠

Graphics client

The graphical client is available on Windows and macOS.

1. Install the Cyberduck client.
2. Start Cyberduck and click New Connection.
3. In the box with profiles, select More options. A separate settings window opens.
4. In the Profiles section, check the Selectel S3 Cloud Storage profile . To work with the profile, the container must have Virtual-Hosted addressing enabled.
5. In the new connection window, in the profiles field, select Selectel S3 Cloud Storage.
6. In the Access Key field, insert the value of the Access key field from the S3 key.
7. In the Secret Key field, insert the value of  the Secret key field from the S3 key.
8. Click Connect.

Console client

Learn more about working with the console client in the Command Line Interface (CLI) instructions of the Cyberduck documentation.

Windows

The console version of Cyberduck for Windows is installed using the Chocolatey package manager.

1. Open a command prompt with administrator privileges.

2. Install the Chocolatey package manager.

3. Install Cyberduck:

   choco install duck

4. To install all packages, type 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 a 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 a directory with the profiles:

   mkdir -p ~/.duck/profiles

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

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

macOS

The console 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 a directory with the profiles:

   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 through 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>/<container_name>

Specify:

• <pool> — pool where the object storage is located;
• <access_key> — field value Access key from S3 key;
• <secret_key> — field value Secret key from the S3 key;
• <command> — Cyberduck command, some commands can be found in the CLI documentation;
• <s3_domain> — S3 API domain depends on pool in which the object storage is located;
• <container_name> — container name.