aria_s3_copy - Linux


aria_s3_copy is a command-line utility used to copy objects between Amazon Simple Storage Service (S3) buckets. It relies on the aria2c engine to handle multi-threaded downloads and uploads, optimizing transfer speeds and reliability.


aria_s3_copy [options] <source-bucket-path> <source-object-name> <destination-bucket-path> <destination-object-name>


  • -a, –access-key-id : Specify the S3 access key ID.
  • -k, –secret-access-key : Specify the S3 secret access key.
  • -b, –bucket-name : Define the bucket name.
  • -e, –endpoint : Set the S3 endpoint URL.
  • -r, –region : Indicate the S3 region.
  • -p, –process-number : Specify the number of concurrent threads (default: 1).
  • -m, –max-connection-per-server : Set the maximum number of connections per server (default: 10).
  • -v, –verbose: Enable verbose output.
  • –help: Display help information.


Simple Copy:

aria_s3_copy my-source-bucket my-source-object my-destination-bucket my-destination-object

Copy with Credentials:

aria_s3_copy \
  --access-key-id AKIAIOSFODNN7EXAMPLE \
  --secret-access-key wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY \
  my-source-bucket my-source-object my-destination-bucket my-destination-object

Copy with Region and Endpoint:

aria_s3_copy \
  --region us-west-1 \
  --endpoint \
  my-source-bucket my-source-object my-destination-bucket my-destination-object

Common Issues

  • Invalid Credentials: Ensure you provide valid S3 access key ID and secret access key.
  • Insufficient Permissions: Verify that you have the necessary permissions to copy the objects in the source and destination buckets.
  • Network Connectivity: Check your network connectivity and ensure that you can access the S3 endpoints.


Combine with rsync for Incremental Updates:

rsync --dry-run source-folder/ s3://destination-bucket/folder/ | aria_s3_copy --process-number 4

Use as a Download Manager with wget:

wget -O - | aria_s3_copy --destination-bucket-path local-dir --destination-object-name file.txt

Related Commands

  • aws s3 cp: AWS CLI command for copying S3 objects.
  • s3cmd: Open-source command-line tool for managing S3 objects.