Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Co-authored-by: Cursor <cursoragent@cursor.com>
75 lines
1.6 KiB
Markdown
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)
|