ARM-based processors have gained popularity due to their energy-saving capabilities and performance as shown in the recent adoptions by Apple. Previously a mainstay for mobile, edge, or small devices, ARM-based chips are now used for almost all types of systems, including servers. 

This surge in the use of ARM-based systems means development toolchains have to support building for the ARM architecture reliably and efficiently. It is here where the GitLab Runner shines, allowing users to run CI/CD jobs on ARM servers. Coupling the GitLab Runner with the Oracle Cloud Infrastructure (OCI) offerings of ARM-based compute instances lets development teams have best in class CI/CD infrastructure to target both ARM and x86 architecture. The recommended method of installing GitLab is using the automated deployment options for OCI by clicking the "Deploy to Oracle Cloud" button, which takes advantage of full-tested scripts for single click deployment through the OCI console.s.

If you will be deploying manually on virtual machines on OCI, there are certain caveats users need to be aware of when setting up GitLab Runner and GitLab on an OCI ARM-based instance.

How to set up GitLab CI/CD on ARM instances

The core feature of GitLab CI/CD is the runner – it executes all the instructions to accomplish the jobs in the CI/CD pipelines. One of its strengths is the support for the diverse architecture and operating systems, including Oracle Linux server distribution running on ARM-based systems. This functionality allows users to maintain diverse runners targeting different architectures for the various workloads of development teams.

Installing the GitLab Runner on ARM-based instances is straightforward: After adding the official GitLab package repository, install the runner. However, if you are running Oracle Linux Server release 8.x (ol/8), you will need to manually set up the package repository, because ol/8 by PackageCloud, which GitLab uses to host packages, is not supported.

To set up the repository manually use the following commands:

curl >
chmod +x
os=el dist=8 ./

How to set up GitLab EE/Core on ARM instances

Similar to the Runner, you will need to manually set up GitLab's package repository if you are running ol/8. The commands are similar, aside from the package URL as shown below:

curl >
chmod +x
os=el dist=8 ./
EXTERNAL_URL="[GITLAB-INSTANCE-URL]" dnf install -y gitlab-ee

One caveat to deploying to recent versions of GitLab using Omnibus is the ARM64 cow bug affecting Redis, which is bundled with GitLab Omnibus installations. This bug only affects GitLab versions from 13.9 – which was the version in which the bundled Redis was upgraded to 6.0.10. You can install pre-13.9 versions of GitLab manually. For example, to install version 13.8use the command: yum install gitlab-ee-13.8.6-ee.0.el8.aarch64.

The fix for the bug is pulled into the 6.0 branch of the Redis upstream project and will make its way to future GitLab releases. The bug only affects Redis on ARM64 architecture (aarch64) and is not specific to GitLab or the Oracle Linux server. You can disable the bundled Redis instance and configure a separate local Redis instance or an external service.

Watch and learn

Watch the video to see how to set up a Runner on an OCI ARM64 instance running the Oracle Linux server.

Try all GitLab features - free for 30 days

GitLab is more than just source code management or CI/CD. It is a full software development lifecycle & DevOps tool in a single application.

Try GitLab Free
Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license

Try GitLab risk-free for 30 days.

No credit card required. Have questions? Contact us.

Gitlab x icon svg