nephatrine/gitea-runner repository overview

⁠Gitea Actions Runner

This is an Alpine-based container hosting a Gitea Actions runner for performing your own CI/CD builds. You can have multiple such runners connected to a Gitea server.

WARNING: Please note that the runner itself runs as the root user inside the container. Only allow trusted users and organizations access to your runner.

⁠Supported Tags

• gitea-runner:0.6.1: gitea-runner 1.0.8 (upstream)
• gitea-runner:liteyuki: gitea-runner 1.0.8 w/ allowed_repos config from liteyuki-runner

⁠Software

• Alpine Linux⁠
• Skarnet S6⁠
• s6-overlay⁠
• gitea-runner⁠

⁠Configuration

This is the only configuration file you will likely need to be aware of and potentially customize.

• /mnt/config/etc/gitea-runner.yaml

Modifications to this file will require a service restart to pull in the changes made.

⁠Container Variables

• TZ: Time Zone (i.e. America/New_York)
• PUID: Mounted File Owner User ID
• PGID: Mounted File Owner Group ID
• DOCKER_HOST: Docker Host (i.e. unix:///var/run/docker.sock)
• GITEA_INSTANCE_URL: Gitea Instance URL
• GITEA_RUNNER_REGISTRATION_TOKEN: Token from Gitea
• GITEA_RUNNER_NAME: Runner Name

⁠Testing

⁠docker-compose

services:
  gitea-runner:
    image: nephatrine/gitea-runner:latest
    container_name: gitea-runner
    environment:
      TZ: America/New_York
      PUID: 1000
      PGID: 1000
      GITEA_INSTANCE_URL: https://gitea.example.net
      GITEA_RUNNER_REGISTRATION_TOKEN:
      GITEA_RUNNER_NAME: test
    volumes:
      - /mnt/containers/gitea-runner:/mnt/config
      - /var/run/docker.sock:/run/docker.sock

⁠docker run

docker run --rm -ti code.nephatrine.net/nephnet/gitea-runner:latest /bin/bash