var img = document.createElement('img'); img.src = "https://easystat.de/piwik.php?idsite=13&rec=1&url=https://docs.servinga.cloud" + location.pathname; img.style = "border:0"; img.alt = "tracker"; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(img,s);
Skip to main content

Use S3 with s3cmd

s3cmd is a free command line tool for interacting with S3-compatible object storage buckets. In its most basic form it can be used to upload and download files to and from S3, but you can also manage bucket lifecycle policies, set bucket permissions and recursively sync directories.

It relies on Python and is therefore available on most Linux distributions as well as Windows and macOS. Due to its open source nature, you can find the source code as well as recent releases and their associated download files on GitHub. You'll also find it as package in most default repositories of major Linux distributions under the name s3cmd.

Configuration​

By default, s3cmd will look for a configuration file in ~/.s3cfg, however you can always override that behavior by adding the -c /path/to/config option to your command.

The configuration file is a simple INI-style file and should look like this for using s3cmd with servinga's S3 Object Storage:

[default]
access_key = AAAAAAAAAAAAAAAAA
secret_key = 000000000000000000000000000000000
check_ssl_certificate = True
guess_mime_type = True
host_base = https://nl.s3.servinga.cloud
host_bucket = https://nl.s3.servinga.cloud
use_https = True

Make sure to replace the access_key and secret_key with your own credentials of the storage user that has been associated with the bucket you're trying to access.

Limitations​

Please notice that it's not possible to create new buckets or to remove existing ones using S3 APIs with servinga S3 Object Storage. The management of buckets needs to happen via our customer portal and can not be carried out via CLI tools.