ForgejoRunner

ForgejoRunner

Docker 应用程序 from MaybeGrim's Repository

概述

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.

要求

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

运行时参数

网络
bridge
外壳
bash
特权
false
额外参数
--user 0:0

模板配置

Data PathPathrw

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

目标
/data
默认值
/mnt/user/appdata/forgejo-runner/data
价值
/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.

目标
/var/run/docker.sock
默认值
/var/run/docker.sock
价值
/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.

默认值
unix:///var/run/docker.sock
价值
unix:///var/run/docker.sock

详细信息

存储库
data.forgejo.org/forgejo/runner:6
最后更新2026-05-31
初见2026-05-01

在Unraid 上运行 ForgejoRunner 。

ForgejoRunner 已被列入Unraid OS 的社区应用程序。探索Unraid ,构建灵活的家庭服务器、NAS 或家庭实验室。