AWS S3 Command Line Clients for Windows, Linux, Mac. Backup to S3, upload, retrieve, query data on Amazon S3.

S3cmd Home | S3cmd Download | FAQ / KB

S3cmd: FAQ and Knowledge Base

Main Page > Browse Categories > Tips, Tricks and More > About the s3cmd configuration file

About the s3cmd configuration file

The s3cmd configuration file is named .s3cfg and it is located in the user's home directory, e.g. /home/username/ ($HOME).

On Windows the configuration file is called s3cmd.ini and it is located in %USERPROFILE% -> Application Data , usually that is c:\users\username\AppData\Roaming\s3cmd.ini

The s3cmd configuration file contains all s3cmd settings. This includes the Amazon access key and secret key for s3cmd to use to connect to Amazon S3.

A basic configuration file is created automatically when you first issue the s3cmd --configure command after installation. You will be asked a few questions about your Amazon access key and secret key and other settings you wish to use, and then s3cmd will save that information in a new config file.

Other advanced settings can be changed (if needed) by editing the config file manually. Some of the settings contain the default values for s3cmd to use. For instance, you could change the multipart_chunk_size_mb default value from 15 to 5, and that would become the new default value for the s3cmd option --multipart-chunk-size-mb.

The following is an example of a s3cmd config file:

[default]

access_key = TUOWAAA99023990001

access_token = 

add_encoding_exts = 
 
add_headers = 

bucket_location = US 

cache_file = 

cloudfront_host = cloudfront.amazonaws.com 

default_mime_type = binary/octet-stream 

delay_updates = False 

delete_after = False 

delete_after_fetch = False 

delete_removed = False 

dry_run = False 

enable_multipart = True 

encoding = UTF-8 

encrypt = False 

expiry_date = 

expiry_days = 

expiry_prefix = 

follow_symlinks = False 

force = False 

get_continue = False 

gpg_command = /usr/bin/gpg 

gpg_decrypt = %(gpg_command)s -d --verbose --no-use-agent --batch --yes --passphrase-fd %(passphrase_fd)s -o %(output_file)s %(input_file)s 

gpg_encrypt = %(gpg_command)s -c --verbose --no-use-agent --batch --yes --passphrase-fd %(passphrase_fd)s -o %(output_file)s %(input_file)s 

gpg_passphrase = 
 
guess_mime_type = True 

host_base = s3.amazonaws.com 

host_bucket = %(bucket)s.s3.amazonaws.com 

human_readable_sizes = False 

ignore_failed_copy = False 

invalidate_default_index_on_cf = False 

invalidate_default_index_root_on_cf = True 

invalidate_on_cf = False 

list_md5 = False 

log_target_prefix = 

max_delete = -1 

mime_type = 

multipart_chunk_size_mb = 15 

preserve_attrs = True 

progress_meter = True 

proxy_host = 

proxy_port = 0 

put_continue = False 

recursive = False 

recv_chunk = 4096 

reduced_redundancy = False 

restore_days = 1 

secret_key = sd/ceP_vbb#eDDDK 

send_chunk = 4096 

server_side_encryption = False 

simpledb_host = sdb.amazonaws.com 

skip_existing = False 

socket_timeout = 300 

urlencoding_mode = normal 

use_https = True 

use_mime_magic = True 

verbosity = WARNING 

website_endpoint = http://%(bucket)s.s3-website-% (location)s.amazonaws.com/ 

website_error = 

website_index = index.html

User Comments

There are no user comments for this topic.

Attachments
No attachments

Did this help you?

Yes

No

Statistics
53% found this information useful

Other Options
Printable Version

Download S3Cmd

A printable version of the entire FAQ and Knowledge Base is also available.

For further queries or questions, please contact us.