Sign inSign up

mainto/github-runner

By mainto

•Updated over 3 years ago

Self hosted runner on docker container

Image
0

219

mainto/github-runner repository overview

⁠Github Runner on Docker

Self hosted runner on docker container

⁠Usage

You don't need to change docker-compose.yml file. Just copy and use the file from repository. However, you need to create a .env file.

Please check .env.example file.

When the 2 files are ready, run below command

docker-compose up -d

OR

docker compose up -d
⁠docker-compose.yml
version: "3"

services:
  github-runner:
    # Docker Hub Registry
    # image: mainto/github-runner:latest

    # Github Container Registry
    image: ghcr.io/mainto/docker-github-runner:latest
    privileged: true
    volumes:
      - github-runner-volume:/runner
    environment:
      - GIT_URL=${GIT_URL}
      - TOKEN=${TOKEN}
    restart: unless-stopped
volumes:
  github-runner-volume:
⁠.env
# Project name must be unique on your docker host (for volume)
COMPOSE_PROJECT_NAME=github-runner

# Github Repository - ex) https://github.com/{USER}/{REPO}
GIT_URL=https://github.com/mainto/docker-github-runner

# You can get a token here: 
# https://github.com/{USER}/{REPO}/settings/actions/runners/new
TOKEN=ABCDEF012345678900SAMPLETOKEN
⁠Environments

All 3 environment values are required

COMPOSE_PROJECT_NAME
This is project name. It must be unique on your docker host. It will prevent to use same volume.
GIT_URL
This is your Github Repository URL
ex) https://github.com/mainto/docker-github-runner⁠
TOKEN
You can get a token here: https://github.com/{USER}/{REPO}/settings/actions/runners/new⁠
  • TOKEN will be expired after few minutes.
  • After runner is registered as github runner, you don't need to get new TOKEN. Credentials will be stored on docker volume.
  • When restart this docker container, stored credentials will be reused.

Tag summary

Content type

Image

Digest

sha256:45796c09d…

Size

478.7 MB

Last updated

over 3 years ago

docker pull mainto/github-runner