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

75 lines
1.6 KiB
Markdown

# 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:
- https://gitea.d-bis.org/-/admin/actions/runners
- Or org-level: https://gitea.d-bis.org/d-bis/settings/actions/runners
2. **Docker** (optional but recommended) — For running jobs in isolated containers. Install on dev-vm if not present.
---
## Install act_runner
```bash
# 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:
```bash
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`:
```ini
[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
```
```bash
systemctl daemon-reload
systemctl enable --now act-runner
```
---
## Enable Actions per repository
Repositories must enable Actions: Repository → Settings → Enable Repository Actions
---
## References
- [Gitea Actions Quick Start](https://docs.gitea.com/usage/actions/quickstart)
- [act_runner](https://gitea.com/gitea/act_runner)