GitHub Actions Runner

Self-hosted GitHub Actions Runner, now available in a Docker container.

Getting Started

Example using Headless Mode:

docker run -d \
  -e GITHUB_REPOSITORY="..." \
  -e GITHUB_TOKEN="..." \
  -e RUNNER_NAME="SelfHostedRunner-001" \
  -e REPLACE_EXISTING_RUNNER="true" \
  joeyx22lm/docker-github-actions-runner

Example using Interactive Mode:

docker run -it \
  -e INTERACTIVE_MODE="true" \
  joeyx22lm/docker-github-actions-runner

Interactive Mode

The runner can be executed in an Interactive Mode, allowing the user to manually provide runner configuration at runtime. Interactive Mode can be enabled using the INTERACTIVE_MODE environment variable. No other environment variables are required for this mode.

Headless Mode

Interactive Mode can be disabled by using or omitting the INTERACTIVE_MODE environment variable.

In order for the GitHub Action Runner to begin listening without any interaction, the following environment variables must be populated:

• GITHUB_REPOSITORY
• GITHUB_TOKEN

Environment Variables

Name	Description	Default	Example
GITHUB_REPOSITORY	GitHub Repository URL	""	"https://github.com/joeyx22lm/example"
GITHUB_TOKEN	GitHub API Token	""	N/A
RUNNER_NAME	Self-hosted Runner Name	<hostname>	N/A
WORK_DIR	Working Directory	.workdir	N/A
REPLACE_EXISTING_RUNNER	Replace existing runner with matching name. Ignored when using Interactive Mode.	false	true or false
INTERACTIVE_MODE	Don't skip runner configuration prompt	false	true or false

Releases

Docker Tags

Tag	Description
alpha	Not Stable. Regularly updated from the development branch.
latest	Stable. Latest Version.
<version>	Stable.

Changelog

Release	Description
v0.1.0	Added support for runner name, custom working directory, interactive mode and runner replacement policy.
v0.0.1	Ubuntu 16.04, Runner v2.160.0