Docker images provided by CodeBuild - Amazon CodeBuild
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Docker images provided by CodeBuild

A supported image is the latest major version of an image available in CodeBuild and is updated with minor and patch version updates. CodeBuild optimizes the provisioning duration of builds with supported images by caching them in the machine's Amazon Machine Images (AMI). If you want to benefit from caching and minimize the provisioning duration of your build, select Always use the latest image for this runtime version in the Image version section of the CodeBuild console instead of a more granular version, such as aws/codebuild/amazonlinux2-x86_64-standard:4.0-1.0.0.

CodeBuild frequently updates the list of Docker images to add the latest images and deprecate old images. To get the most current list, do one of the following:

  • In the CodeBuild console, in the Create build project wizard or Edit Build Project page, for Environment image, choose Managed image. Choose from the Operating system, Runtime, and Runtime version drop-down lists. For more information, see Create a build project (console) or Change a build project's settings (console).

  • For the Amazon CLI, run the list-curated-environment-images command:

    aws codebuild list-curated-environment-images
  • For the Amazon SDKs, call the ListCuratedEnvironmentImages operation for your target programming language. For more information, see the Amazon SDKs and tools reference.

The base image of the Windows Server Core 2019 platform is only available in the following regions:

  • US East (N. Virginia)

  • US East (Ohio)

  • US West (Oregon)

  • Europe (Ireland)

EC2 compute images

Amazon CodeBuild supports the following Docker images that are available for EC2 compute in CodeBuild.

Platform Image identifier Definition
Amazon Linux 2 aws/codebuild/amazonlinux2-x86_64-standard:4.0 al2/standard/4.0
Amazon Linux 2023 aws/codebuild/amazonlinux2-x86_64-standard:5.0 al2/standard/5.0
Amazon Linux 2 aws/codebuild/amazonlinux2-x86_64-standard:corretto8 al2/standard/corretto8
Amazon Linux 2 aws/codebuild/amazonlinux2-x86_64-standard:corretto11 al2/standard/corretto11
Amazon Linux 2 aws/codebuild/amazonlinux2-aarch64-standard:2.0 al2/aarch64/standard/2.0
Amazon Linux 2023 aws/codebuild/amazonlinux2-aarch64-standard:3.0 al2/aarch64/standard/3.0
Ubuntu 20.04 aws/codebuild/standard:5.0 ubuntu/standard/5.0
Ubuntu 22.04 aws/codebuild/standard:6.0 ubuntu/standard/6.0
Ubuntu 22.04 aws/codebuild/standard:7.0 ubuntu/standard/7.0
Windows Server Core 2019 aws/codebuild/windows-base:2019-1.0 N/A
Windows Server Core 2019 aws/codebuild/windows-base:2019-2.0 N/A
Windows Server Core 2019 aws/codebuild/windows-base:2019-3.0 N/A
Windows Server Core 2022 aws/codebuild/windows-base:2022-1.0 N/A

Lambda compute images

Amazon CodeBuild supports the following Docker images that are available for Amazon Lambda compute in CodeBuild.

aarch64 Architecture
Platform Image identifier Definition
Amazon Linux 2 aws/codebuild/amazonlinux-aarch64-lambda-standard:dotnet6 al-lambda/aarch64/dotnet6
Amazon Linux 2 aws/codebuild/amazonlinux-aarch64-lambda-standard:go1.21 al-lambda/aarch64/go1.21
Amazon Linux 2 aws/codebuild/amazonlinux-aarch64-lambda-standard:corretto11 al-lambda/aarch64/corretto11
Amazon Linux 2 aws/codebuild/amazonlinux-aarch64-lambda-standard:corretto17 al-lambda/aarch64/corretto17
Amazon Linux 2023 aws/codebuild/amazonlinux-aarch64-lambda-standard:corretto21 al-lambda/aarch64/corretto21
Amazon Linux 2 aws/codebuild/amazonlinux-aarch64-lambda-standard:nodejs18 al-lambda/aarch64/nodejs18
Amazon Linux 2023 aws/codebuild/amazonlinux-aarch64-lambda-standard:nodejs20 al-lambda/aarch64/nodejs20
Amazon Linux 2 aws/codebuild/amazonlinux-aarch64-lambda-standard:python3.11 al-lambda/aarch64/python3.11
Amazon Linux 2023 aws/codebuild/amazonlinux-aarch64-lambda-standard:python3.12 al-lambda/aarch64/python3.12
Amazon Linux 2 aws/codebuild/amazonlinux-aarch64-lambda-standard:ruby3.2 al-lambda/aarch64/ruby3.2
x86_64 Architecture
Platform Image identifier Definition
Amazon Linux 2 aws/codebuild/amazonlinux-x86_64-lambda-standard:dotnet6 al-lambda/x86_64/dotnet6
Amazon Linux 2 aws/codebuild/amazonlinux-x86_64-lambda-standard:go1.21 al-lambda/x86_64/go1.21
Amazon Linux 2 aws/codebuild/amazonlinux-x86_64-lambda-standard:corretto11 al-lambda/x86_64/corretto11
Amazon Linux 2 aws/codebuild/amazonlinux-x86_64-lambda-standard:corretto17 al-lambda/x86_64/corretto17
Amazon Linux 2023 aws/codebuild/amazonlinux-x86_64-lambda-standard:corretto21 al-lambda/x86_64/corretto21
Amazon Linux 2 aws/codebuild/amazonlinux-x86_64-lambda-standard:nodejs18 al-lambda/x86_64/nodejs18
Amazon Linux 2023 aws/codebuild/amazonlinux-x86_64-lambda-standard:nodejs20 al-lambda/x86_64/nodejs20
Amazon Linux 2 aws/codebuild/amazonlinux-x86_64-lambda-standard:python3.11 al-lambda/x86_64/python3.11
Amazon Linux 2023 aws/codebuild/amazonlinux-x86_64-lambda-standard:python3.12 al-lambda/x86_64/python3.12
Amazon Linux 2 aws/codebuild/amazonlinux-x86_64-lambda-standard:ruby3.2 al-lambda/x86_64/ruby3.2

Deprecated images

A deprecated image is an image that is no longer cached or updated by CodeBuild. A deprecated image no longer receives minor version updates or patch version updates, and because they are no longer updated, using them may not be secure. If your CodeBuild project is configured to use an older image version, the provisioning process will download this docker image and use it to create the containerized runtime environment, which can increase the provisioning duration and overall build duration.

CodeBuild has deprecated the following Docker images. You can still use these images, but they won't be cached on the build host and will result in higher provisioning times.

Platform Image identifier Definition Deprecation date
Amazon Linux 2 aws/codebuild/amazonlinux2-x86_64-standard:3.0 al2/standard/3.0 May 9, 2023
Ubuntu 18.04 aws/codebuild/standard:4.0 ubuntu/standard/4.0 March 31, 2023
Amazon Linux 2 aws/codebuild/amazonlinux2-aarch64-standard:1.0 al2/aarch64/standard/1.0 March 31, 2023
Ubuntu 18.04 aws/codebuild/standard:3.0 ubuntu/standard/3.0 June 30, 2022
Amazon Linux 2 aws/codebuild/amazonlinux2-x86_64-standard:2.0 al2/standard/2.0 June 30, 2022