snootic/forgejo-runner-awaker
Watch
1
0
Fork
You've already forked forgejo-runner-awaker
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Simple webhook server to wake up Forgejo ephemeral runners
2 commits 1 branch 0 tags 20 KiB
  • Python 100%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Snootic 14134c089d Update README.md
2026-07-27 00:44:13 -03:00
.env.example initial commit 2026-07-27 00:35:11 -03:00
.gitignore initial commit 2026-07-27 00:35:11 -03:00
.python-version initial commit 2026-07-27 00:35:11 -03:00
compose.lab.yaml initial commit 2026-07-27 00:35:11 -03:00
compose.yaml initial commit 2026-07-27 00:35:11 -03:00
dockerfile initial commit 2026-07-27 00:35:11 -03:00
main.py initial commit 2026-07-27 00:35:11 -03:00
pyproject.toml initial commit 2026-07-27 00:35:11 -03:00
README.md Update README.md 2026-07-27 00:44:13 -03:00
uv.lock initial commit 2026-07-27 00:35:11 -03:00

README.md

Forgejo Runner Awaker

A webhook listener that starts an ephemeral Forgejo runner when a workflow job is queued.

Run

Set FORGEJO_API_URL and REGISTRATION_TOKEN, then start the service:

docker compose up --build -d

Configure Forgejo to send workflow_job webhooks to POST /webhook. The service needs access to /var/run/docker.sock to start runner containers.