Files
proxmox/docs/04-configuration/GITEA_ACT_RUNNER_SETUP.md
defiQUG bea1903ac9
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Sync all local changes: docs, config, scripts, submodule refs, verification evidence
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-21 15:46:06 -08:00

1.6 KiB

Gitea act_runner Setup

Last Updated: 2026-02-10
Gitea: https://gitea.d-bis.org
Runner host: dev-vm (VMID 5700) at 192.168.11.59


Prerequisites

  1. Registration token — Get from Gitea Admin → Actions → Runners:

  2. Docker (optional but recommended) — For running jobs in isolated containers. Install on dev-vm if not present.


Install act_runner

# From Proxmox host, run inside dev-vm:
GITEA_RUNNER_REGISTRATION_TOKEN=<token> ssh root@192.168.11.11 "pct exec 5700 -- bash -s" < scripts/dev-vm/setup-act-runner.sh

Or SSH into dev-vm (192.168.11.59) and run manually:

cd /opt  # or preferred dir
GITEA_RUNNER_REGISTRATION_TOKEN=<token> bash /path/to/setup-act-runner.sh
cd /opt/act_runner && ./act_runner daemon

Run as systemd service

Create /etc/systemd/system/act-runner.service:

[Unit]
Description=Gitea act_runner
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/act_runner
ExecStart=/opt/act_runner/act_runner daemon
Restart=on-failure
RestartSec=10
Environment=GITEA_ACTION_URL=http://192.168.11.59:3000

[Install]
WantedBy=multi-user.target
systemctl daemon-reload
systemctl enable --now act-runner

Enable Actions per repository

Repositories must enable Actions: Repository → Settings → Enable Repository Actions


References