# GitHub Runner

GitHub Runner is a self-hosted development app. GitHub Actions Runner is the application that executes jobs from your GitHub Actions workflows, letting you self-host runners on your own servers to build and test your code in your environment. It is open source and self-hosted, installable on Proxmox.

Canonical page: https://ourlocalhost.com/app/4513/github-runner

## Description

GitHub Actions Runner is the application that executes jobs from your GitHub Actions workflows, letting you self-host runners on your own servers to build and test your code in your environment.

## Platform availability

Available on 1 of 10 platforms: Proxmox.

## Health score

68/100 (Good), based on 5 of 5 factors.
- Maintained: 100 (last commit 4 days ago)
- Popular: 76 (6,399 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Light to run: 10 (7 GB minimum RAM)
- Security check: 82 (no serious findings, 1 minor, CI, tests, OpenSSF Scorecard 6.5/10)

## Links

- GitHub: https://github.com/actions/runner
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=github-runner

## Common questions

### What must be set before starting a Docker-based GitHub Actions runner?

Set RUNNER_SCOPE and the matching value such as REPO_URL, ORG_NAME, or ENTERPRISE_NAME. You also need to provide a personal access token, GitHub App private key, or pre-created runner token.

### What runner configuration should be backed up when using the community Docker runner?

Back up the runner settings in /actions-runner/.runner and any persistent folder such as CONFIGURED_ACTIONS_RUNNER_FILES_DIR. Keep the folder permissions intact so the runner can still read its saved name, labels, and configuration.

### Does GitHub provide an official container image for self-hosted runners?

No, GitHub does not provide an official container image for self-hosted runners. Running GitHub Actions runners in containers is possible but not officially supported, so people often use community-maintained images.

### Can a self-hosted runner be online while workflow jobs remain queued?

Yes, users report self-hosted runners that appear online but randomly leave jobs stuck in the queued state. This can happen across different workflow steps at different times.

### What network access does the host machine need for a self-hosted runner?

The host machine must have appropriate network access with at least 70 kilobits per second upload and download speed.

---
Source: Our Local Host (https://ourlocalhost.com/app/4513/github-runner), the self-hosted and open-source app directory.
