Docker GitHub Actions Runner

Docker GitHub Actions Runner is a Docker container for developers and homelab users who want to run self-hosted GitHub Actions runners on their own…

  • Development
  • Other
  • Productivity
  • Tools & Utilities
Docker GitHub Actions Runner is a Docker container for developers and homelab users who want to run self-hosted GitHub Actions runners on their own infrastructure, with Docker-in-Docker support.

Platform availability

Available on 1 of 10 platforms

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

73/100 Good

Maintained
100last commit 23 days ago
Popular
682,522 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
602 GB minimum RAM, runs on ARM
Security check
74no serious findings, CI, OpenSSF Scorecard 5.7/10

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

GitHub stars
2,522
Open issues
3
Last commit
2026-10-29
Latest release
2.338.2
License
GPL-3.0
Activity
rising

Checked 21 days ago - source: GitHub (myoung34/docker-github-actions-runner)

Resources & Compatibility

Minimum requirements: 2 GB RAM, 10 GB disk. ARM (e.g. Raspberry Pi) is supported.

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

First-install notes

  • Set runner scope and required GitHub details Before starting the container, tell it whether you're connecting to a repository, organization, or enterprise and fill in the matching variable (REPO_URL, ORG_NAME, or ENTERPRISE_NAME) plus your authentication token or GitHub App details. Without these, the container can't validate its settings and the runner will not register with GitHub. source
  • Provide a valid GitHub token or App login Use a personal access token, GitHub App private key and app details, or an already-made runner token so the container can get permission to register itself. If the login doesn't allow self-hosted runner access, the start-up process stops and no jobs will run. source
  • Let the container own its runner folders By default the container creates and fixes ownership of /actions-runner (runner config) and /_work (job files) for its runner user. If you mount your own folders for those paths, make sure they're readable/writable by the container user, or jobs may fail with permission errors. source

Fetched 54 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Which environment variables tell the runner container which GitHub scope to use?

Set REPO_URL for a repository, ORG_NAME for an organization, or ENTERPRISE_NAME for an enterprise before starting the container. The matching authentication token or GitHub App details are also required.

Why can the container stop during startup and prevent jobs from running?

The startup process stops when the supplied GitHub token or App login does not allow self-hosted runner access.

What file permissions are needed if I mount my own runner or work directories?

If you mount /actions-runner or /_work, make sure the container user can read and write them. The container otherwise creates and fixes ownership of those folders for its runner user.

Does the project run Docker inside the self-hosted runner?

Yes, it runs the new self-hosted GitHub Actions runners with docker-in-docker.

Answers sourced from github.com, github.com

Community

Collected 48 days ago - public community threads