← Directory

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…

  • 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 9 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (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.

71/100 Good

Maintained
99last commit 41 days ago
Popular
48248 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

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

GitHub stars
248
Open issues
0
Last commit
2026-09-02
License
MIT
Activity
stale

Checked 10 days ago - source: GitHub (gitlabhq/gitlab-runner)

Resources & Compatibility

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

Checked 14 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

Fetched 10 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.
  • 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 - An all-in-one project management platform (alternative to Linear, Jira, Slack, Notion, Motion)
  • Jenkins - Jenkins is an open-source automation server that runs continuous integration and delivery (CI/CD) pipelines to automatically build, test, a…
  • Launchpad - Launchpad is a collaboration and Bazaar code hosting platform for (primarily open-source) software projects.
  • Plane - Plane is an open-source project management tool for tracking issues, running cycles, and managing product roadmaps.
  • Radicle - Open source, peer-to-peer collaboration on Git enables decentralized, censorship-resistant code sharing, local-first autonomy, and modular…
  • Semaphore - Semaphore is a modern web interface for Ansible that lets homelab users run playbooks, receive failure notifications, and control access to…
  • SourceForge - Open source community and software directory offering code hosting, analytics, version control, project management, and access to over 50,0…

Checked 11 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 14 days ago - public community threads