custom-portainer-configurations/templates/gitea-runner

Gitea Actions Runner (Portainer template)

Gitea Actions Runner (act_runner) is a runner for Gitea Actions. It is compatible with GitHub Actions and allows you to run CI/CD workflows within your Gitea instance.

Quick notes:

• Registration: You will need a registration token from your Gitea instance (Site Administration > Actions > Runners).
• Docker-in-Docker: To run container-based actions, the runner requires access to the Docker socket (/var/run/docker.sock).
• Persistence: Ensure the data volume is mapped to persist the runner configuration and registration state.

Usage:

1. Import the compose file into Portainer's Stacks or App Templates.
2. Configure the GITEA_INSTANCE_URL and GITEA_RUNNER_REGISTRATION_TOKEN environment variables.
3. Ensure the volume mapping for /var/run/docker.sock is correctly set if you plan to use Docker-based workflows.
4. Deploy the stack via Portainer.
5. Verify the runner appears as "Online" in your Gitea settings.

Helpful links:

• Gitea Actions Documentation: https://docs.gitea.com/usage/actions/overview
• Runner Repository: https://gitea.com/gitea/act_runner
• Docker Hub: https://hub.docker.com/r/gitea/act_runner

Status: Ready for configuration