Customized github-actions-runner Docker Image

Based on the official Docker image of Github's action runner, this Docker image provides an easy way spin up a self-hosted GitHub Action Runner.

Upon shutdown the runner will automatically be disconnected from the GitHub repository.

Example docker-compose.yml

version: '3.6'

services:
  github-runner:
    image: ghcr.io/stonemaster/github-actions-runner:main
    container_name: githubrunner
    restart: always
    environment:
      - GITHUB_REPO_URL=https://github.com/stonemaster/github-actions-runner
      - RUNNER_TOKEN=

Environment variables

GITHUB_REPO_URL (required)

Example: https://github.com/stonemaster/github-actions-runner

The https URL of the GitHub repository.

RUNNER_TOKEN (required)

The runner token as provided by the GitHub configuration on the new self-hosted runner configuration page on GitHub.com.

PRE_JOB_SCRIPT and POST_JOB_SCRIPT (both optional)

These environment variables contain Base64 encoded scripts. If set they will be run before starts and after a job has completed. As per the offical documentation these scripts should be written in bash or sh. The container makes sure the scripts are executable after decoding them.

Scripts can easily be converted into Base64 on the command-line and then used as an environment variable:

$ cat script.sh
#!/bin/bash
echo "Hello World!"
$ base64 script.sh
IyEvYmluL2Jhc2gKZWNobyAiSGVsbG8gV29ybGQhIgo=

Add the Base64 string as an environment variable:

  [...]
    environment:
      - RUNNER_TOKEN=123
      - PRE_JOB_SCRIPT=IyEvYmluL2Jhc2gKZWNobyAiSGVsbG8gV29ybGQhIgo=
  [...]

SHUTDOWN_RUNNER_SCRIPT (optional)

Similar to the PRE_JOB_SCRIPT and POST_JOB_SCRIPT environment variables this allows to specify a Base64-encoded script to be run at shutdown of the runner. The script is run after disconnecting the runner from GitHub.