{"repo":"youssefbrr/self-hosted-runner","free":true,"listed":false,"github":"https://github.com/youssefbrr/self-hosted-runner","clone":"git clone https://github.com/youssefbrr/self-hosted-runner.git","description":"Dockerized solution for setting up a self-hosted GitHub Actions runner. Easily deploy and scale your runners using Docker Compose.","language":"Dockerfile","stars":129,"topics":[],"license":"MIT","category":"self-hosted-apps","readme_excerpt":"Self-Hosted GitHub Actions Runner Dockerized GitHub Actions self-hosted runners for Linux (x64) and macOS (ARM64). Deploy in minutes, scale with replicas, deregister cleanly on shutdown. --- Quick Start Linux (x64) macOS / ARM64 REG TOKEN expires after 1 hour. Generate a fresh one from GitHub → Settings → Actions → Runners → \"New self-hosted runner\" before each deploy. --- Pre-built Image vs Local Build Both variants support pre-built images from GHCR. By default, docker-compose up pulls the pre-built image — no build step required. Variant Image Tag --------- ------- ----- Linux (x64) ghcr.io/youssefbrr/self-hosted-runner latest macOS / ARM64 ghcr.io/youssefbrr/self-hosted-runner latest-arm64 Mode How When to use ------ ----- ------------- Pre-built (default) Just run docker-compose up Quick setup, no customization needed Local build Uncomment build: . in the compose file Custom Dockerfile changes, runner version overrides --- Features - Zero-config start — set 3 env vars and run - Clean shutdown — SIGINT/SIGTERM deregisters the runner automatically - Scalable — Linux defaults to 2 replicas; tune with deploy.replicas - Ephemeral mode — run once and self-destruct ( EPHEMERAL=true ) - Docker-in-Docker — macOS image mounts the Docker socket for nested builds - GitHub CLI — gh pre-installed from official repos on both variants - Docker CLI — official Docker CE CLI with buildx and compose plugins - Healthchecks — built-in pgrep run.sh health monitoring on both variants --- Archit","default_branch":null,"files":null,"tree":[],"storefront":"/r/youssefbrr","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/youssefbrr/self-hosted-runner/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}