ForgejoRunner
ForgejoRunner
Docker app from MaybeGrim's Repository
Overview
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.
- Create the data directory: mkdir -p /mnt/user/appdata/forgejo-runner/data
- Generate config: docker run --rm data.forgejo.org/forgejo/runner:6 forgejo-runner generate-config > /mnt/user/appdata/forgejo-runner/data/runner-config.yml
- Register the runner (see support thread for full command).
- 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.
Requirements
Runtime arguments
- Network
bridge- Shell
bash- Privileged
- false
- Extra Params
--user 0:0
Template configuration
Persistent storage for runner registration (.runner file), config, and cache. Contains the authentication token after registration — do not delete.
- Target
- /data
- Default
- /mnt/user/appdata/forgejo-runner/data
- Value
- /mnt/user/appdata/forgejo-runner/data
Host Docker socket. Allows the runner to create sibling containers for workflow jobs. Required for Docker-based job execution.
- Target
- /var/run/docker.sock
- Default
- /var/run/docker.sock
- Value
- /var/run/docker.sock
Docker daemon endpoint. Default uses the mounted host socket. Change to tcp://host:port if using a remote Docker daemon or Docker-in-Docker.
- Default
- unix:///var/run/docker.sock
- Value
- unix:///var/run/docker.sock
Categories
Details
data.forgejo.org/forgejo/runner:6Run ForgejoRunner on Unraid.
ForgejoRunner is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.