GitLab Runner

GitLab Runner is an open-source CI/CD (continuous integration/continuous delivery) agent that runs GitLab CI/CD jobs and returns results to your GitLab…

  • Development
  • Tools & Utilities
GitLab Runner is an open-source CI/CD (continuous integration/continuous delivery) agent that runs GitLab CI/CD jobs and returns results to your GitLab instance. This Docker executor template is for developers and homelab users who want a self-hosted runner that registers automatically after you enter the GitLab URL, registration token, and runner name.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

62/100 Good

Maintained
100last commit 1 day ago
Popular
48251 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
No data
Security check
201 serious finding, 8 minor, CI, tests, OpenSSF Scorecard 3.2/10

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 9 days ago

GitHub stars
251
Open issues
0
Last commit
2026-11-20
License
MIT
Activity
declining

Checked yesterday - source: GitHub (gitlabhq/gitlab-runner)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install the runner as a service Run: sudo gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner, then run: sudo gitlab-runner start. This tells GitLab Runner which user and folder to use, and keeps it running as a background service instead of stopping when you close the terminal. source
  • Make sure the PATH includes /usr/local/bin If the runner was installed under /usr/local/bin, add that folder to PATH or install the runner in /usr/bin. PATH is the list of folders Linux checks for programs, and without this the service manager cannot find and start gitlab-runner. source
  • Version compatibility The runner version must fall within your GitLab version's compatible range — check the compatibility table at docs.gitlab.com/runner before registering. source

Fetched 9 days ago - each note links to its source

Alternatives (12)

  • Bitbucket - Offers Git-based code hosting, integrated issue tracking, a project wiki, pull requests, and collaboration tools with support for private o…
  • Forgejo - Forgejo is a self-hosted, lightweight Git forge for hosting repositories and managing projects.
  • Gerrit - Gerrit is an open-source, web-based code review and project management platform for Git repositories that enables development teams to coll…
  • GitBucket - GitBucket is a self-hosted Git web platform built in Scala that provides a lightweight GitHub-compatible repository, issue, pull request, a…
  • GitHub - Web-based Git hosting service facilitating collaboration, with features like issue tracking, social networking, and wikis for project manag…
  • Gitea - Gitea is a lightweight, self-hosted Git service for hosting and managing Git repositories, pull requests, and issues.
  • Gogs - Gogs is a self-hosted Git service for hosting code repositories with web interfaces and Git command-line workflows.
  • Huly - Huly is a self-hostable, all-in-one project management platform that unifies task boards, chat, wiki, and time tracking in a single workspa…
  • Jenkins - Jenkins is a fork of Hudson and is a continuous build system for software projects.
  • Launchpad - Launchpad is a collaboration and Bazaar code hosting platform for (primarily open-source) software projects.
  • Pagure - A Git center project hosting with bug reporting tools.
  • Plane - Plane is an open-source project management tool for tracking issues, running cycles, and managing product roadmaps.

Checked 51 days ago - source: AlternativeTo

Common questions

Why does the GitLab Runner service fail to start if the binary is in /usr/local/bin?

Add /usr/local/bin to PATH or install the runner binary in /usr/bin, because the service manager uses PATH to find gitlab-runner.

Do GitLab and GitLab Runner versions need to be compatible?

Yes, check the GitLab Runner compatibility section for which GitLab CE/EE versions work with each runner version.

How can I register a runner when the GitLab server uses a self-signed certificate?

Specify the GitLab server certificate file for self-signed certificates during registration to avoid the x509: certificate signed by unknown authority error.

Should I keep runner auto-registration enabled on a self-hosted GitLab instance?

Disable the auto-registration option for security when self-hosting GitLab.

Answers sourced from docs.gitlab.com, github.com, stackoverflow.com, www.reddit.com

Community

Collected 54 days ago - public community threads