ForgejoRunner

ForgejoRunner

Application Docker from MaybeGrim's Repository

Vue d'ensemble

Forgejo Runner executes CI/CD workflows for Forgejo Actions, the built-in continuous integration system in Forgejo (a self-hosted Git forge).

This template uses host Docker socket mode — the runner dispatches workflow jobs as sibling containers on your Unraid Docker daemon. No Docker-in-Docker or privileged mode needed.

SETUP: You must register the runner before starting the container.

  1. Create the data directory: mkdir -p /mnt/user/appdata/forgejo-runner/data
  2. Generate config: docker run --rm data.forgejo.org/forgejo/runner:6 forgejo-runner generate-config > /mnt/user/appdata/forgejo-runner/data/runner-config.yml
  3. Register the runner (see support thread for full command).
  4. Start this container — the runner will connect and begin picking up jobs.

The container must run as root (user 0:0) for Docker socket access on Unraid.

Exigences

A running Forgejo instance with Actions enabled. You must register the runner before first start.

Arguments d'exécution

Réseau
bridge
Coquille
bash
Privilégié
false
Paramètres supplémentaires
--user 0:0

Configuration du modèle

Data PathPathrw

Persistent storage for runner registration (.runner file), config, and cache. Contains the authentication token after registration — do not delete.

Cible
/data
Défaut
/mnt/user/appdata/forgejo-runner/data
Valeur
/mnt/user/appdata/forgejo-runner/data
Docker SocketPathrw

Host Docker socket. Allows the runner to create sibling containers for workflow jobs. Required for Docker-based job execution.

Cible
/var/run/docker.sock
Défaut
/var/run/docker.sock
Valeur
/var/run/docker.sock
DOCKER_HOSTVariable

Docker daemon endpoint. Default uses the mounted host socket. Change to tcp://host:port if using a remote Docker daemon or Docker-in-Docker.

Défaut
unix:///var/run/docker.sock
Valeur
unix:///var/run/docker.sock

Catégories

Détails

Référentiel
data.forgejo.org/forgejo/runner:6
Dernière mise à jour2026-05-31
Première vue2026-05-01

Exécutez ForgejoRunner sur Unraid.

ForgejoRunner est listé dans Community Apps pour Unraid OS. Explorez Unraid pour créer un serveur domestique flexible, un NAS ou un laboratoire domestique.