Skip to main content
Last update:


S3cmd is a command-line interface for working with services that support Amazon S3 HTTP API (S3 API).

Customize S3cmd

  1. Configure access.
  2. Install client.
  3. Create S3cmd configuration.

1. Configure access

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

  1. Create a service user with a role with access to object storage, see Role Model Access for details.
  2. Issue the user an S3 key.

2. Install the client

From GitHub S3cmd download and install the client.

3. Create s3cmd configuration

  1. Open the terminal.

  2. Open the configuration mode:

    s3cmd --configure
  3. Enter Access Key — the value of the Access key field from S3-key.

  4. Enter Secret Key — the value of the Secret key field from the S3 key.

  5. Enter Default Region — pool.

  6. Enter S3 Endpoint — where ru-1 is pool.

  7. Enter the DNS-style bucket+hostname:port template for accessing a bucket — The settings will be saved in the ~/.s3cfg file:

    access_key = <access_key>
    secret_key = <secret_key>
    bucket_location = ru-1
    host_base =
    host_bucket =

Working with S3cmd

See the Usage instructions of the S3cmd documentation for all commands.

Create a container

Create a container:

s3cmd mb s3://<container_name>

Specify <container_name> as the name of the new container.

View a list of facilities

Check out the list of facilities:

s3cmd ls s3://<container_name>

Specify <container_name> is the name of the container.

Download the object

Load the object:

s3cmd put <path> s3://<container_name>/<prefix>


  • <path> — path to the file in the local directory;
  • <container_name> is the name of the container;
  • <prefix> — Optional: prefix, by which the object will be loaded.

Delete object

Delete the object:

s3cmd rm s3://<container_name>/<object_name>


  • <container_name> is the name of the container;
  • <object_name> is the name of the object.