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 20.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
This image can be used with the CircleCI
machine executor and can also be used with the ARM resource class.
1 2 3 4 5 6 7 8 9 10 11jobs: build: machine: image: ubuntu-2004:2023.07.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
2023.07.1 indicates the dated version of the base image.
See how tags work below for more information.
This image contains the Ubuntu Linux operating system and everything needed to run most builds on CircleCI. This includes but is not limited to:
build-essentialpackage containing compiling tools
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 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
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.