thingies

ansible/services/forgejo-runner/SETUP.md

@@ -0,0 +1,28 @@
+# Forgejo Runner Setup
+
+## Obtaining the Registration Token
+
+1. Log in to the Forgejo instance at `https://forgejo.contrapeso.xyz`
+2. Go to **Site Administration** > **Actions** > **Runners**
+3. Click **Create new runner**
+4. Copy the registration token
+
+## Configuring the Token
+
+Paste the token into `ansible/infra_secrets.yml`:
+
+```yaml
+forgejo_runner_registration_token: "YOUR_TOKEN_HERE"
+```
+
+## Running the Playbook
+
+```bash
+ansible-playbook ansible/services/forgejo-runner/deploy_forgejo_runner_playbook.yml
+```
+
+## Verifying
+
+1. On the VM: `systemctl status forgejo-runner` should show active
+2. In Forgejo: **Site Administration** > **Actions** > **Runners** should show the runner as online
+3. In Uptime Kuma: the `forgejo-runner-healthcheck` push monitor should be receiving pings