ForgejoRunner

ForgejoRunner

Docker-Anwendung from MaybeGrim's Repository

Übersicht

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.

Anforderungen

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

Laufzeit-Argumente

Netzwerk
bridge
Shell
bash
Privilegiert
false
Extra Params
--user 0:0

Konfiguration der Vorlage

Data PathPathrw

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

Ziel
/data
Standard
/mnt/user/appdata/forgejo-runner/data
Wert
/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.

Ziel
/var/run/docker.sock
Standard
/var/run/docker.sock
Wert
/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.

Standard
unix:///var/run/docker.sock
Wert
unix:///var/run/docker.sock

Kategorien

Einzelheiten

Repository
data.forgejo.org/forgejo/runner:6
Zuletzt aktualisiert2026-05-31
Erstmals gesehen2026-05-01

Führen Sie ForgejoRunner auf Unraid aus.

ForgejoRunner ist gelistet in Community Apps für Unraid OS. Erkunden Sie Unraid, um einen flexiblen Heimserver, ein NAS oder ein Heimlabor aufzubauen.