Cyberduck

Last update: November 12 2024

Cyberduck

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

Customize Cyberduck⁠

1. Configure access.
2. Configure the client.

Set up access⁠

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

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

Configure the client⁠

Graphics client

The graphical client is available on Windows and macOS.

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

Console client

More information about working with the console client in the manual Command Line Interface (CLI) Cyberduck documentation.

Windows

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

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 Selectel's profile file.

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

Linux

1. Open the terminal.

2. Add a repository duck:

   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 package manager Homebrew.

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 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 of the commands can be seen in the CLI documentation;
• <s3_domain> — S3 API domain depends on pool where the object storage is located;
• <container_name> — container name.