Start Building for Free
  • ubuntu-2204
  • Getting Started
  • How This Image Works
  • Image Tags
  1. Machine Images
  2. ubuntu-2204



Our ubuntu machine image is the default for machine pipelines and remote Docker instances within CircleCI and is built with continuous integration in mind. This image is a standalone Ubuntu 22.04 virtual machine.

This image contains the minimum tools required to operate a build on CircleCI (such as git) as well as extremely popular and useful tools in CircleCI (such as docker).

Getting Started

This image can be used with the CircleCI machine executor and can also be used with the ARM resource class. For example:

1 2 3 4 5 6 7 8 9 10 11 jobs: build: machine: image: ubuntu-2204:2024.05.1 # If running ARM, the resource class needs to be added. Omitting this defaults to amd64 resource_class: arm.medium steps: - checkout # Whatever you want to do - run: sudo apt-get update && sudo apt-get install -y cowsay - run: cowsay Continuous Integration Rocks!

In the above example, the CircleCI Ubuntu image is used as the virtual machine image. More specifically, the tag 2024.05.1 indicates the dated version of the base image. See how tags work below for more information.

How This Image Works

This image contains the Ubuntu Linux operating system and everything needed to run most builds on CircleCI. This includes but is not limited to:

  • Git
  • Docker and Docker Compose
  • The build-essential package containing compiling tools
  • jq
  • curl, ssh, and much more

Tagging Scheme

Images in this family are tagged by their release date. This creates a snapshot to use where you know the items in the image won't change on you. When determinism for your CI pipeline is crucial, these are the images you want to use. The format for these tags are YYYY.MM.X where YYYY is the 4-digit year, MM is the two-digit month, and X is the numbered release that month. Unless an important patch release is done, X will typically be 1.

There is also a current tag which will always point to the most recent supported release. This tags means you don't have to keep track of the latest version and manually update your config, with the trade off that it can on occasion include a breaking change.

Older tags in this family are tagged by their release date as YYYYMM-DD.

Image Tags

  • 2024.05.1
  • 2024.04.4
  • 2024.01.2
  • 2024.01.1
  • 2023.10.1
  • 2023.07.2
  • 2023.04.2
  • 2023.04.1
  • 2023.02.1
  • 2022.10.2
  • 2022.10.1
  • 2022.07.2
  • 2022.07.1
  • 2022.04.2
  • 2022.04.1
  • current
  • edge
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.