Developer
Documentation
Login
Home
Home
Images
Images
Developer
Documentation
Login
Home
Home
Images
Images
  • ubuntu-2004
  • Getting Started
  • How This Image Works
  • Image Tags
  1. Machine Images
  2. ubuntu-2004

ubuntu-2004

Sections

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 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 docker).

Getting Started

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

1 2 3 4 5 6 7 8 9 jobs: build: machine: image: ubuntu-2004:2022.04.2 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 2022.04.2 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

  • 2022.04.2
  • 2022.04.1
  • 202201-02
  • 202201-01
  • 202111-02
  • 202111-01
  • 202107-02
  • 202104-01
  • 202101-01
  • 202010-01
  • current
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.