s3cmd(1) General Commands Manual s3cmd(1) (NAME) s3cmd - Amazon S3 Amazon CloudFront (SYNOPSIS) s3cmd [OPTIONS] COMMAND [PARAMETERS] (DESCRIPTION) s3cmd / Amazon S3 ( ) . (COMMANDS) s3cmd . s3cmd mb s3://BUCKET s3cmd rb s3://BUCKET s3cmd ls [s3://BUCKET[/PREFIX]] s3cmd la s3cmd put FILE [FILE...] s3://BUCKET[/PREFIX] s3cmd get s3://BUCKET/OBJECT LOCAL_FILE s3cmd del s3://BUCKET/OBJECT s3cmd rm s3://BUCKET/OBJECT ( del) s3cmd restore s3://BUCKET/OBJECT Glacier s3cmd sync LOCAL_DIR s3://BUCKET[/PREFIX] or s3://BUCKET[/PREFIX] LOCAL_DIR or s3://BUCKET[/PREFIX] s3://BUCKET[/PREFIX] S3 ( md5 ) s3cmd du [s3://BUCKET[/PREFIX]] s3cmd info s3://BUCKET[/OBJECT] s3cmd cp s3://BUCKET1/OBJECT1 s3://BUCKET2[/OBJECT2] s3cmd modify s3://BUCKET1/OBJECT s3cmd mv s3://BUCKET1/OBJECT1 s3://BUCKET2[/OBJECT2] s3cmd setacl s3://BUCKET[/OBJECT] (ACL) s3cmd setversioning s3://BUCKET enable|disable s3cmd setownership s3://BUCKET BucketOwnerPreferred|BucketOwnerEnforced|ObjectWriter s3cmd setblockpublicaccess s3://BUCKET BlockPublicAcls,IgnorePublicAcls,BlockPublicPolicy,RestrictPublicBuckets s3cmd setobjectlegalhold STATUS s3://BUCKET/OBJECT s3cmd setobjectretention MODE RETAIN_UNTIL_DATE s3://BUCKET/OBJECT s3cmd setpolicy FILE s3://BUCKET s3cmd delpolicy s3://BUCKET s3cmd setcors FILE s3://BUCKET CORS s3cmd delcors s3://BUCKET CORS s3cmd payer s3://BUCKET s3cmd multipart s3://BUCKET [Id] s3cmd abortmp s3://BUCKET/OBJECT Id s3cmd listmp s3://BUCKET/OBJECT Id s3cmd accesslog s3://BUCKET / s3cmd sign STRING-TO-SIGN s3cmd signurl s3://BUCKET/OBJECT S3 s3cmd fixbucket s3://BUCKET[/PREFIX] s3cmd settagging s3://BUCKET[/OBJECT] "KEY=VALUE[&KEY=VALUE ...]" s3cmd gettagging s3://BUCKET[/OBJECT] s3cmd deltagging s3://BUCKET[/OBJECT] s3cmd expire s3://BUCKET s3cmd setlifecycle FILE s3://BUCKET s3cmd getlifecycle s3://BUCKET s3cmd dellifecycle s3://BUCKET s3cmd setnotification FILE s3://BUCKET s3cmd getnotification s3://BUCKET s3cmd delnotification s3://BUCKET s3cmd ws-create s3://BUCKET s3cmd ws-delete s3://BUCKET s3cmd ws-info s3://BUCKET CloudFront s3cmd cflist CloudFront s3cmd cfinfo [cf://DIST_ID] CloudFront s3cmd cfcreate s3://BUCKET CloudFront s3cmd cfdelete cf://DIST_ID CloudFront.TP s3cmd cfmodify cf://DIST_ID CloudFront s3cmd cfinval s3://BUCKET/OBJECT [s3://BUCKET/OBJECT ...] (Invalidate) CloudFront s3cmd cfinvalinfo cf://DIST_ID[/INVAL_ID] () CloudFront (OPTIONS) s3cmd ( $HOME/.s3cmd) . . -h, --help --configure ( ). '--configure s3://some-bucket' . -c FILE, --config=FILE . $HOME/.s3cfg . --dump-config . --access_key=ACCESS_KEY (Access Key) AWS --secret_key=SECRET_KEY (Secret Key) AWS --access_token=ACCESS_TOKEN (Access Token) AWS -n, --dry-run . S3 ( ). -s, --ssl HTTPS S3. () --no-ssl HTTPS. -e, --encrypt S3. --no-encrypt . -f, --force . --continue ( [get]). --continue-put (multipart). md5 . md5 . : md5sum () . . --upload-id=UPLOAD_ID UploadId ( --continue-put) . s3cmd multipart [URI] UploadId URI . --skip-existing ( [get] [sync]). -r, --recursive (recursive). --check-md5 MD5 [sync]. () --no-check-md5 MD5 [sync]. . . -P, --acl-public ACL . --acl-private ACL . --acl-grant=PERMISSION:EMAIL or USER_CANONICAL_ID . : read write read_acp write_acp full_control all --acl-revoke=PERMISSION:USER_CANONICAL_ID . : read write read_acp write_acp full_control all -D NUM, --restore-days=NUM ( 'restore'). . --restore-priority=RESTORE_PRIORITY S3 Glacier ( 'restore'). : bulk standard expedited --delete-removed [sync] --no-delete-removed [sync] --delete-after delete-removed [sync] --delay-updates ** [sync] --max-delete=NUM NUM . [del] [sync] --limit=NUM ( [ls] [la]) --add-destination=ADDITIONAL_DESTINATIONS . . --delete-after-fetch ( [get] [sync]). -p, --preserve ( ). [sync]. --no-preserve --keep-dirs . . --exclude=GLOB GLOB (sync) --exclude-from=FILE GLOB --exclude FILE --rexclude=REGEXP REGEXP ( ) (sync) --rexclude-from=FILE REGEXP --rexclude FILE.TP --include=GLOB GLOB --(r)exclude(-from) . --include-from=FILE GLOB --include FILE. --rinclude=REGEXP --include GLOB REGEXP ( ) . --rinclude-from=FILE REGEXP --rinclude FILE. --files-from=FILE FILE. stdin - . --region=REGION, --bucket-location=REGION (Region) . : us-east-1 us-west-1 us-west-2 eu-west-1 eu-central-1 ap-northeast-1 ap-southeast-1 ap-southeast-2 sa-east-1 --host=HOSTNAME HOSTNAME:PORT S3 (: s3.amazonaws.com s3-eu-west-1.amazonaws.com). --host-bucket . --host-bucket=HOST_BUCKET bucket+hostname:port DNS (: %(bucket)s.s3.amazonaws.com) --reduced-redundancy, --rr <> ( ). . [ put cp mv] --no-reduced-redundancy, --no-rr <>. . [ put cp mv] --storage-class=CLASS CLASS (STANDARD STANDARD_IA ONEZONE_IA INTELLIGENT_TIERING GLACIER DEEP_ARCHIVE). [ put cp mv] --access-logging-target-prefix=LOG_TARGET_PREFIX (S3 URI) ( [cfmodify] [accesslog]) --no-access-logging ( [cfmodify] [accesslog]) --default-mime-type=DEFAULT_MIME_TYPE MIME . binary/octet-stream . -M, --guess-mime-type MIME mime magic. MIME-Type --default-mime-type --no-guess-mime-type MIME . --no-mime-magic mime magic MIME. -m MIME/TYPE, --mime-type=MIME/TYPE MIME. --default-mime-type --guess-mime-type. --add-header=NAME:VALUE HTTP . . 'Expires' 'Cache-Control' ( ) . --remove-header=NAME HTTP. . 'Expires' 'Cache-Control' ( ) . [ modify] --server-side-encryption . [ put sync cp modify] --server-side-encryption-kms-id=KMS_KEY AWS KMS (SSE-KMS) . [ put sync cp modify] --encoding=ENCODING ( ) . : UTF-8 --add-encoding-exts=EXTENSIONs (css,js,html) S3. --verbatim S3 . . ! --disable-multipart --multipart-chunk-size-mb --multipart-chunk-size-mb=SIZE . SIZE . SIZE 15MB 5MB 5GB . --list-md5 MD5 ( 'ls'). --list-allow-unordered AWS . . . -H, --human-readable-sizes ( 1kB 1234). --ws-index=WEBSITE_INDEX (index-document) ( [ws-create]) --ws-error=WEBSITE_ERROR (error-document) ( [ws-create]) --expiry-date=EXPIRY_DATE ( [expire]). --expiry-days=EXPIRY_DAYS ( [expire]). --expiry-prefix=EXPIRY_PREFIX ( [expire]). --skip-destination-validation Amazon SQS Amazon SNS AWS Lambda ( [setnotification]). --progress ( TTY). --no-progress ( TTY). --stats . --enable CloudFront ( [cfmodify]). --disable CloudFront ( [cfmodify]). --cf-invalidate (Invalidate) CloudFront. [cfinval] . --cf-invalidate-default-index Custom Origin S3 (index) ..TP --cf-no-invalidate-default-index-root Custom Origin S3 . --cf-add-cname=CNAME CNAME CloudFront ( [cfcreate] [cfmodify]) --cf-remove-cname=CNAME CNAME CloudFront ( [cfmodify]) --cf-comment=COMMENT COMMENT CloudFront ( [cfcreate] [cfmodify]) --cf-default-root-object=DEFAULT_ROOT_OBJECT (URL) . default/index.html /default/index.html s3://bucket/default/index.html ( [cfcreate] [cfmodify]) -v, --verbose . -d, --debug . --version s3cmd (2.4.0) . -F, --follow-symlinks --cache-file=FILE FILE MD5 -q, --quiet (stdout) --ca-certs=CA_CERTS_FILE SSL CA CA_CERTS_FILE ( ) --ssl-cert=SSL_CLIENT_CERT_FILE SSL CRT_FILE --ssl-key=SSL_CLIENT_KEY_FILE SSL KEY_FILE --check-certificate SSL --no-check-certificate SSL --check-hostname SSL --no-check-hostname SSL --signature-v2 AWS . S3 AWS . --limit-rate=LIMITRATE . k m --no-connection-pooling --requester-pays REQUESTER PAYS -l, --long-listing [ls] --stop-on-error --max-retries=NUM . --content-disposition=CONTENT_DISPOSITION Content-Disposition : "inline; filename=myvideo.mp4" --content-type=CONTENT_TYPE Content-Type : "video/mp4".SH " (EXAMPLES)" s3cmd s3cmd sync S3 . s3cmd put s3cmd get sync . : s3cmd sync /local/path/ s3://test-bucket/backup/ /local/path s3://test-bucket/backup . : /local/path/file1.ext -> s3://bucket/backup/file1.ext /local/path/dir123/file2.bin -> s3://bucket/backup/dir123/file2.bin . : s3cmd sync /local/path s3://test-bucket/backup/ : /local/path/file1.ext -> s3://bucket/backup/path/file1.ext /local/path/dir123/file2.bin -> s3://bucket/backup/path/dir123/file2.bin S3 : s3cmd sync s3://test-bucket/backup/ ~/restore/ : s3://bucket/backup/file1.ext -> ~/restore/file1.ext s3://bucket/backup/dir123/file2.bin -> ~/restore/dir123/file2.bin : s3cmd sync s3://test-bucket/backup ~/restore/ : s3://bucket/backup/file1.ext -> ~/restore/backup/file1.ext s3://bucket/backup/dir123/file2.bin -> ~/restore/backup/dir123/file2.bin ( ) exclude include . --exclude --include . path/file1.ext /local/path/file1.ext --exclude --include ( GLOB) . s3cmd (Regular-expression) --rexclude --rinclude . ...-from ( --rinclude-from) . . --(r)exclude(-from) include . --exclude --rinclude-from . s3cmd --dry-run . --debug exclude include . ".jpg" : --exclude '*.jpg' --rinclude '[0-9].*.jpg' "*.jpg" : --exclude '*' --include '*.jpg' 'somedir' : --exclude 'somedir/' : s3cmd --help : https://s3tools.org (AUTHORS) Michal Ludvig Florent Viard (CONTACT, SUPPORT) : s3tools-general@lists.sourceforge.net : https://s3tools.org (BUGS) : s3tools-bugs@lists.sourceforge.net (COPYRIGHT) (C) 2007-2023 TGRMN Software (https://www.tgrmn.com) Sodria SAS (https://www.sodria.com) . (LICENSE) (GNU General Public License) (Free Software Foundation) ( ) . . . s3cmd(1)