Image Overview: aws-cli-v2

Overview: aws-cli-v2 Chainguard Image

Minimal aws-cli v2 container image.

Download this Image

The image is available on

docker pull


Before using the aws-cli Chainguard Image, you need to configure your AWS credentials. There are a number of ways you can do this, so we encourage you to review the official AWS credentials documentation to determine what method works best for you.

AWS credentials and configurations are typically stored in a directory named .aws. Assuming you’ve already set up your AWS credentials locally, you can share them from your host machine to a container by mounting this directory as a volume. The following command follows this method to pass along AWS credentials in order to retrieve a list of EKS clusters:

docker run --rm -it -v ~/.aws:/home/nonroot/.aws:ro s3 ls

Note that Chainguard’s aws-cli Image has a single user nonroot with uid 65532, belonging to gid 65532.; the previous command mounts the local .aws directory under this user’s home directory. Be aware that if you follow this method you may need to adjust the permissions of your local credentials file in order for the container to be able to read it.

You can get help with any command when using the AWS Command Line Interface (AWS CLI) by following any command name with help. For example, the following command displays help for the general AWS CLI options and the available top-level commands:

docker run --rm help

The following command displays help information for the aws ec2 run-instances command:

docker run --rm ec2 run-instances help

Please refer to the official Getting Started guide for more information.

Last updated: 2024-04-11 12:38