Start Building for Free
  • cimg/aws
  • Getting Started
  • How This Image Works
  • Image Tags
  1. Convenience Images
  2. cimg/aws



cimg/aws is a Docker image created by CircleCI with continuous delivery and deployment pipelines in mind. It contains the AWS CLI, related tools, and is based on the cimg/deploy image. Each tag is a date-based snapshot.

Getting Started

This image can be used with the CircleCI docker executor. For example:

1 2 3 4 5 6 7 jobs: build: docker: - image: cimg/aws:2024.03 steps: - checkout - run: aws --version

In the above example, the CircleCI AWS Docker image is used for the primary container. You can now use all of the tools pre-installed in this image in this job.

How This Image Works

This image is published on a monthly basis. Each month, we'll update the main tools to newer versions as they are available.

Tagging Scheme

This image has the following tagging scheme:


The tag will be YYYY.MM.I where YYYY is the 4 digit year, MM is the 2 digit month, and I is the nth release of that month. The last piece there typically will only change when we need to patch an image for that month.

Image Tags

Developer Updates
Get tips to optimize your builds
Or join our research panel and give feedback
By submitting this form, you are agreeing to ourTerms of UseandPrivacy Policy.