marvin8/own-forge
Watch
1
0
Fork
You've already forked own-forge
 0
Code Issues Pull requests Wiki Activity Actions

Add On-Server Runner (Suanni) section to deployments workbook #6

Manually merged
marvin8 merged 3 commits from docs/suanni-runner-section into main 2026-08-03 08:21:54 +00:00
Conversation 1 Commits 3 Files changed 3 +269
agent-pi commented 2026-08-02 09:22:03 +00:00
Collaborator
Copy link

Adds a new Tier 3 section documenting how to set up a Forgejo Actions runner directly on the VPS, using podman for containerised job execution.

The runner is named Suanni (狻猊) — the dragon-son who sits still and watches until something is off.

Covers:

  • System user and group creation (forgejo-runner + podman)
  • Runner config YAML with suanni label
  • systemd service definition
  • Registration against forge.marvin8.zone
  • Verification and smoke-test workflow
  • Label migration note for repos moving from Codeberg
Adds a new Tier 3 section documenting how to set up a Forgejo Actions runner directly on the VPS, using podman for containerised job execution. The runner is named Suanni (狻猊) — the dragon-son who sits still and watches until something is off. **Covers:** - System user and group creation (forgejo-runner + podman) - Runner config YAML with suanni label - systemd service definition - Registration against forge.marvin8.zone - Verification and smoke-test workflow - Label migration note for repos moving from Codeberg
- docker_host must point at podman socket, not '-' or empty
- ExecStart requires --config flag to find config.yml
- Attribute paths with hyphens need quoting in Nix
- Registration: copy UUID + token from Forgejo admin dialog
  directly into config.yml; register CLI is deprecated
- Connection YAML keys: url (not endpoint), uuid, token, labels
- Fix unquoted forgejo-runner in remaining attribute paths
Manually triggered via workflow_dispatch — echo runner hostname,
arch, and kernel to verify each runner is alive.
marvin8 approved these changes 2026-08-03 08:21:30 +00:00
marvin8 manually merged commit 7e1b7c88b5 into main 2026-08-03 08:21:54 +00:00
marvin8 deleted branch docs/suanni-runner-section 2026-08-03 08:22:01 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
marvin8
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Assignees
Clear assignees
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
marvin8/own-forge!6
No description provided.