Gitea Runner

Docker Compose setup for running self-hosted Gitea Act Runners.

Setup

1. Copy the example env file and add your runner registration token:

   cp .env.example .env
   

   Get the token from your Gitea instance under Site Administration → Runners → Create Runner.

2. Start a runner:

   docker compose up -d
   

Scaling Runners

Use the provided scripts to tear down and recreate runners at a given scale. This clears ephemeral containers and frees disk space.

Linux/macOS:

./recreaterunners.sh <scale>

Windows (PowerShell):

./recreaterunners.ps1 <scale>

<scale> is the number of runner replicas to start (must be a positive integer).

Configuration

Variable	Description
GITEA_INSTANCE_URL	URL of your Gitea instance
GITEA_RUNNER_REGISTRATION_TOKEN	Runner registration token (set in .env)
GITEA_RUNNER_LABELS	Runner labels mapped to Docker images
GITEA_RUNNER_EPHEMERAL	Set to 1 to create a fresh container per job