torvald/github-actions repository overview

⁠🐳 GitHub Actions Self-Hosted Runner for ARM64 (Raspberry Pi)

This image provides a self-hosted GitHub Actions runner compatible with ARM64 architectures, such as the Raspberry Pi 4/5. It is based on debian:bullseye-slim for maximum compatibility with the official GitHub runner binaries.

⁠✅ Features

✅ Fully compatible with ARM64 (Raspberry Pi OS, Debian, etc.)

🐧 Based on debian:bullseye-slim with minimal dependencies

⚙️ Auto-registers to your GitHub repository

♻️ Gracefully unregisters on container stop

🔒 Runs as non-root user (runner)

⁠🚀 Quick Start

⁠🧾 1. Generate a runner token

Go to your repository: Settings → Actions → Runners → New self-hosted runner

⁠🐳 2. Use docker-compose

version: "3.8"
services:
  github-runner:
    image: <your-dockerhub-username>/github-runner:latest
    environment:
      - REPO_URL=https://github.com/YourOrg/YourRepo
      - RUNNER_TOKEN=your_runner_token
    restart: unless-stopped

Launch it:

docker compose up -d

⁠🛠️ Environment Variables

⁠📦 Built With

GitHub Actions Runner

Debian Slim (Bullseye)

Supports Git, curl, ca-certificates, libicu

⁠🧼 Cleanup on Stop

On shutdown, the container automatically removes itself from GitHub to avoid orphaned runners.

⁠⚠️ Notes

❌ Not compatible with Alpine Linux due to glibc requirements.

💾 Use a persistent volume if you want to reuse the same runner name/config.