github-runner

This repository provides a GitHub runner Docker image that is configured to use the host's Docker daemon. The image is available on GitHub Container Registry.

Usage

Run the runner

To run the runner, you need to provide the following environment variables:

• URL: The repository URL or organization URL, e.g., https://github.com/user/repo, https://github.com/user
• RUNNER_TOKEN: The runner registration token. You can get this from the repository's settings.
• RUNNER_NAME: The name of the runner.

You also need to mount the host's Docker socket to allow the runner to use the host's Docker daemon.

docker run -d --name github-runner \
  -e URL=<your-repo-url-or-org-url> \
  -e RUNNER_TOKEN=<your-runner-token> \
  -e RUNNER_NAME=<your-runner-name> \
  -v /var/run/docker.sock:/var/run/docker.sock \
  ghcr.io/trungdv/github-runner