personal_infra/ansible/services/forgejo-runner/SETUP.md

# 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~~
   *(Uptime Kuma was decommissioned 2026-09-11 — this check no longer applies. The
   healthcheck timer still runs on the host but pushes nowhere. See `archive/uptime_kuma/`.)*