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…
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
Variants
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
- GH Actions + Docker on Kubernetes: How to run without ... - Reddit (reddit)
- GitHub Actions runners face 404 error during concurrent builds (forum)
- How do I use Docker with GitHub Actions? - Stack Overflow (forum)
- docker - Github Actions Container is not running - Stack Overflow (forum)
- How much work does it take to operate a self-hosted GitHub ... - Reddit (reddit)
Collected 48 days ago - public community threads