nathan/custom-portainer-configurations

Files

History

Nathan Falvey 63ca609504 refactor(gitea-runner): Correct typo in environment variable example and update volume path

2026-03-03 00:40:08 +00:00

..

docker-compose.yml

refactor(gitea-runner): Correct typo in environment variable example and update volume path

2026-03-03 00:40:08 +00:00

README.md

feat(templates): Add gitea-runner docker-compose file

2026-03-03 00:37:56 +00:00

README.md

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:

Import the compose file into Portainer's Stacks or App Templates.
Configure the GITEA_INSTANCE_URL and GITEA_RUNNER_REGISTRATION_TOKEN environment variables.
Ensure the volume mapping for /var/run/docker.sock is correctly set if you plan to use Docker-based workflows.
Deploy the stack via Portainer.
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