{"id":25400574,"url":"https://github.com/shatnord/github-actions-self-hosted-runner","last_synced_at":"2025-07-01T03:34:56.584Z","repository":{"id":275358500,"uuid":"925834790","full_name":"ShatnoRD/github-actions-self-hosted-runner","owner":"ShatnoRD","description":"Docker image for a GitHub Actions self-hosted runner with all dependencies and a registration script. ","archived":false,"fork":false,"pushed_at":"2025-02-02T00:42:38.000Z","size":23,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-19T08:22:53.645Z","etag":null,"topics":["docker-image","github-actions-runner","self-hosted"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/shatnord/github-actions-self-hosted-runner","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ShatnoRD.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-01T21:23:06.000Z","updated_at":"2025-02-02T00:40:53.000Z","dependencies_parsed_at":"2025-04-12T00:49:21.568Z","dependency_job_id":"87e5f583-017e-4dde-84bd-550cdd230618","html_url":"https://github.com/ShatnoRD/github-actions-self-hosted-runner","commit_stats":null,"previous_names":["shatnord/github-actions-self-hosted-runner"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ShatnoRD/github-actions-self-hosted-runner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ShatnoRD%2Fgithub-actions-self-hosted-runner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ShatnoRD%2Fgithub-actions-self-hosted-runner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ShatnoRD%2Fgithub-actions-self-hosted-runner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ShatnoRD%2Fgithub-actions-self-hosted-runner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ShatnoRD","download_url":"https://codeload.github.com/ShatnoRD/github-actions-self-hosted-runner/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ShatnoRD%2Fgithub-actions-self-hosted-runner/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262889159,"owners_count":23380174,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker-image","github-actions-runner","self-hosted"],"created_at":"2025-02-16T00:18:26.769Z","updated_at":"2025-07-01T03:34:56.559Z","avatar_url":"https://github.com/ShatnoRD.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GitHub Actions Self-Hosted Runner Docker Image\n\nThis 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.\n\n### Releases\n\nIronically, I build this `github-actions-self-hosted-runner` image on GitHub's `ubuntu-latest` runner. I avoid using self-hosted runners for public repos because it's easier and more secure to use GitHub's provided runners for the publish pipeline. The image is built and pushed to Docker Hub and GitHub Packages whenever a new release is published or on demand.\n\nCurrently, there are two separate build workflows for templating reasons:\n\n- [publish_docker_hub.yml](.github/workflows/publish_docker_hub.yml): Builds and pushes the image to Docker Hub.\n- [publish_github_packages.yml](.github/workflows/publish_github_packages.yml): Builds and pushes the image to GitHub Packages.\n\nAlthough this setup could be optimized to use less worker time by combining the two separate ones into a single workflow,this approach allows for clearer separation and templating.\n\n## Usage\n\nTo use this Docker image, you need to set up the necessary environment variables and run the container. The [self-hosted-runner-start.sh](self-hosted-runner-start.sh) script handles the registration and startup of the runner.\n\n### Environment Variables\n\n- `TOKEN`: GitHub personal access token with `repo` and `admin:org` permissions.\n- `REPO`: GitHub repository in the format `owner/repo`.\n- `ORG`: GitHub organization name (if using organization-level runners).\n- `GROUP`: Runner group name (optional).\n- `NAME`: Runner name (optional, defaults to hostname).\n- `LABELS`: Runner labels (optional, defaults to `self-hosted`).\n\n### Example\n\n```sh\ndocker run -e TOKEN=\u003cyour_token\u003e -e REPO=\u003cyour_repo\u003e shatnord/github-actions-self-hosted-runner:latest\n```\n### License\n\nThis project is licensed under the Mozilla Public License 2.0. See the LICENSE file for details.\nThis [README.md](README.md) provides an overview of the project, explains the structure, and details the usage of the Docker image.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshatnord%2Fgithub-actions-self-hosted-runner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshatnord%2Fgithub-actions-self-hosted-runner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshatnord%2Fgithub-actions-self-hosted-runner/lists"}