the official job runner for GitLab CI/CD: it claims your pipeline jobs and runs each one in its own container.
This product is available in the build below. Open it for the operating system, cloud and version detail, or read its deployment guide.
| Product | Cloud | Operating system | Version | |
|---|---|---|---|---|
| GitLab Runner on Ubuntu 24.04 LTS | Azure | Ubuntu 24.04 | Standard | View · Guide |
GitLab CI/CD splits into two halves: the instance that stores the code, the pipeline definitions and the history, and a runner that actually claims a queued job and executes it. Without a runner, pipelines queue and nothing happens. GitLab Runner is the official runner published by the GitLab project. It connects outward to the instance you nominate, using an authentication token you create there for that runner, then claims jobs, runs each one inside a container, streams the log back as it goes and cleans up afterwards. Tags on the runner decide which jobs it will take, so a single instance can direct different work to different machines, and one machine can be added or removed from the pool without touching anything else.
A runner image that carried a registration would hand every deployment the same identity, claiming jobs from, and streaming build logs back to, an instance belonging to somebody else; this image contains no registration, no runner token and no remembered address, and the service will not start until you connect it. Each instance also generates its own unique runner name on first boot, so two runners on one server never collide. Because a runner executes code from anyone who can push to the projects it serves, the boundaries around a job are set deliberately rather than left at their defaults: jobs get no access to the container engine, cannot mount host directories, cannot run privileged, and cannot reach the cloud instance metadata service where a machine identity would be handed out. The executor that would run job scripts directly on the machine is refused outright. The container engine comes from the distribution archive, and the runner's own package source is wired into automatic security updates rather than left to rot, so both keep being patched. An on instance self test runs a real pipeline job and reports back on every one of those boundaries. Paired deployment guide and 24/7 cloudimg support.