shatnord/github-actions-self-hosted-runner repository overview

⁠GitHub Actions Self-Hosted Runner Docker Image

This repository provides the source code for a Docker image that sets up a self-hosted runner for GitHub Actions, including all dependencies and a registration script for your GitHub repo or organization.

⁠Usage

To use this Docker image, you need to set up the necessary environment variables and run the container. The self-hosted-runner-start.sh⁠ script handles the registration and startup of the runner.

⁠Environment Variables

• TOKEN: GitHub personal access token with repo and admin:org permissions.
• REPO: GitHub repository in the format owner/repo.
• ORG: GitHub organization name (if using organization-level runners).
• GROUP: Runner group name (optional).
• NAME: Runner name (optional, defaults to hostname).
• LABELS: Runner labels (optional, defaults to self-hosted).

⁠Example

docker run -e TOKEN=<your_token> -e REPO=<your_repo> shatnord/github-actions-self-hosted-runner:latest

⁠License

This project is licensed under the Mozilla Public License 2.0. See the LICENSE file for details. This README.md⁠ provides an overview of the project, explains the structure, and details the usage of the Docker image.