Ubuntu 22.04 ARM Image#

The ubuntu2204 ARM image is in the Technical Preview stage. Documentation and the image itself are subject to change.

The ubuntu2204 ARM image is a customized image based on Ubuntu 22.04 LTS, which has been optimized for CI/CD. It comes with a set of preinstalled languages, databases, and utility tools commonly used for CI/CD workflows. Please note that the image is available for our ARM agent type: r1-standard-4 when defining the [agent][agent] of your pipeline or block.

The ubuntu2204 image is a virtual machine (VM) image. The user in the environment, named semaphore, has full sudo access. The image will be updated bi-weekly, on the first and third Mondays of every month. Updates can be followed on the Semaphore Changelog.

The ubuntu2204 VM uses an APT mirror located in the same data center as Semaphore's build cluster, which means that caching packages will have little effect.

Using the ubuntu2204 image in your agent configuration#

To use the ubuntu2204 image, define it as the os_image of your agent's machine, as shown below:

version: 1.0
name: Ubuntu2204 ARM Based Pipeline

    type: r1-standard-4
    os_image: ubuntu2204

  - name: "Unit tests"
        - name: Tests
            - make test


sem-service is currently not supported for ARM images.

The ubuntu2204 image comes with two utility tools. One for managing background services and databases, and one for managing language versions.

  • [sem-version: Managing language version on Linux][sem-version]
  • ~[sem-service: Managing databases and services on Linux][sem-service]~

Version control#

Following version control tools are pre-installed:

  • Git 2.42.0
  • Git LFS (Git Large File Storage) 3.4.1
  • GitHub CLI 2.42.1
  • Mercurial 6.1.1
  • Svn 1.14.1

Browsers and Headless Browser Testing#

  • Firefox 115.7.0 (115, default, esr)
  • Geckodriver 0.33.0
  • Chromium 120
  • Chromium Driver 120
  • Xvfb (X Virtual Framebuffer)

Chrome and Firefox both support headless mode. You shouldn't need to do more than install and use the relevant Selenium library for your language. Refer to the documentation of associated libraries when configuring your project.


Docker toolset is installed and the following versions are available:

  • Docker 24.0.7
  • Docker-compose 2.24.2 (used as docker compose version)
  • Docker-buildx 0.12.1
  • Docker-machine 0.16.2
  • Dockerize 0.7.0
  • Buildah 1.23.1
  • Podman 3.4.4
  • Skopeo 1.4.1

Cloud CLIs#

  • Aws-cli 2.15.11 (used as aws)
  • Azure-cli 2.56.0
  • Eb-cli 3.20.10
  • Ecs-cli 1.21.0
  • Doctl 1.102.0
  • Gcloud 425.0.0
  • Gke-gcloud-auth-plugin 425.0.0
  • Kubectl 1.29.1
  • Terraform 1.7.0
  • Helm 3.13.3

Network utilities#

  • Httpie 3.2.2
  • Curl 7.81.0
  • Rsync 3.2.7


  • gcc: 11 (default), 12


Erlang and Elixir#

Erlang versions are installed and managed via kerl. Elixir versions are installed with kiex.

  • Erlang: 24.3, 25.0, 25.1, 25.2, 25.3 (default), 26.0, 26.1, 26.2
  • Elixir: 1.14.x (1.14.5 as default), 1.15.x, 1.16.x

Additional libraries:

  • Rebar3: 3.22.1



  • 1.19.x
  • 1.20.x
  • 1.21.x (1.21.6 as default)

Java and JVM languages#

  • Java: 11.0.21, 17.0.9 (default)
  • Scala: 3.2.2
  • Leiningen: 2.10.0 (Clojure)
  • Sbt 1.9.7

Additional build tools#

  • Maven: 3.9.6
  • Gradle: 8.3

JavaScript via Node.js#

Node.js versions are managed by nvm. You can install any version you need with nvm install [version]. Installed version:

  • v20.11.0 (set as default, with alias 20.11), includes npm 10.2.4

Additional tools#

  • Yarn: 1.22.19


PHP versions are managed by phpbrew. Available versions:

  • 8.1.x
  • 8.2.x
  • 8.3.x

The default installed PHP version is 8.1.27.

Additional libraries#

PHPUnit: 9.5.27


Python versions are installed and managed by virtualenv. Installed versions:

  • 3.10.12 (default)
  • 3.11.7
  • 3.12.1

Supporting libraries:

  • pypy: 7.3.9
  • pypy3: 7.3.15
  • pip: 23.3.2
  • venv: 20.25.0


Available versions:

  • 2.7.0 to 2.7.8
  • 3.0.0 to 3.0.7
  • 3.1.0 to 3.1.6
  • 3.2.0 to 3.2.4
  • 3.3.0 to 3.3.2
  • jruby-
  • jruby-

The default installed Ruby version is 3.2.3.


  • 1.70.0

Installing dependencies with apt package manager#

The Semaphore Ubuntu:22.04 image has most of the popular programming languages, tools and databases preinstalled.

If the dependency you need is not present in the list above, you can install it with the Ubuntu package manager, or using an alternative method such as compiling it from the source or manually downloading binaries.

To install dependecies using the package manager (apt-get) you can use the template command below and add it to your pipeline:

sudo apt-get update
sudo apt-get install -y [your-dependency]

Disabled repositories#

Due to occasional issues with some of the repositories that break the pipeline during apt-get update command, the following sources lists have been moved to /etc/apt/sources.list.d/disabled:

  • azure-cli.list
  • devel_kubic_libcontainers_stable.list
  • docker.list
  • firefox.list
  • git.list
  • google-cloud-sdk.list
  • gradle.list
  • helm.list
  • pypy.list
  • python.list
  • yarn.list

If you need any of these before running the apt-get update command, please move them to the /etc/apt/sources.list.d directory.


sudo mv /etc/apt/sources.list.d/disabled/git.list /etc/apt/sources.list.d/
sudo apt-get update

See Also#