All apps · 0 apps

ForgejoRunner

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.

Install ForgejoRunner on Unraid in a few clicks.

Find ForgejoRunner in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for ForgejoRunner Review the template variables and paths Click Install

Explore Unraid OS

Requirements

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

Related apps

Explore more like this

Explore all

Productivity

Links

Projectcode.forgejo.org Supportforums.unraid.net Registrycode.forgejo.org Templateraw.githubusercontent.com

Details

Repository

data.forgejo.org/forgejo/runner:6

Registry

https://code.forgejo.org/forgejo/-/packages/container/runner/latest

Last Updated2026-07-17

First Seen2026-05-01

Runtime arguments

Network: bridge
Shell: bash
Privileged: false
Extra Params: --user 0:0

Template configuration

Data PathPathrw

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

Docker SocketPathrw

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_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.

Default: unix:///var/run/docker.sock
Value: unix:///var/run/docker.sock

Library

Curated

Categories