https://github.com/nephatrine/docker-gitea-runner

[mirror] Container w/ Gitea-Runner
https://github.com/nephatrine/docker-gitea-runner

docker-image gitea

Last synced: 24 days ago
JSON representation

[mirror] Container w/ Gitea-Runner

• Host: GitHub
• URL: https://github.com/nephatrine/docker-gitea-runner
• Owner: nephatrine
• License: isc
• Created: 2023-04-16T15:21:47.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2026-05-11T01:00:26.000Z (about 2 months ago)
• Last Synced: 2026-05-11T03:09:02.614Z (about 2 months ago)
• Topics: docker-image, gitea
• Language: Dockerfile
• Homepage: https://code.nephatrine.net/NephNET/docker-gitea-runner
• Size: 145 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          


# Gitea Actions Runner

[![Git: NephCode](https://img.shields.io/static/v1?label=Git&message=NephCode&color=teal)](https://code.nephatrine.net/NephNET/docker-gitea-act)

[![Git: GitHub](https://img.shields.io/static/v1?label=Git&message=GitHub&color=teal)](https://github.com/nephatrine/docker-gitea-act)

[![OCI: NephCode](https://img.shields.io/static/v1?label=OCI&message=NephCode&color=blue)](https://code.nephatrine.net/NephNET/-/packages/container/gitea-runner/latest)

[![OCI: DockerHub](https://img.shields.io/static/v1?label=OCI&message=DockerHub&color=blue)](https://hub.docker.com/repository/docker/nephatrine/gitea-runner/general)

[![unRAID](https://img.shields.io/static/v1?label=unRAID&message=template&color=orange)](https://code.nephatrine.net/nephatrine/unraid-containers)

[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)

This is an Alpine-based container hosting a Gitea Actions act_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`: act_runner 0.6.1 (upstream)

- `gitea-runner:liteyuki`: act_runner 0.6.1 w/ allowed_repos config from liteyuki-runner

## Software

- [Alpine Linux](https://alpinelinux.org/)

- [Skarnet S6](https://skarnet.org/software/s6/)

- [s6-overlay](https://github.com/just-containers/s6-overlay)

- [act_runner](https://gitea.com/gitea/act_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

```yaml

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

```sh

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

```