selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
github-act-runner logo

Self-host github-act-runner

v0.13.0

Self-hosted GitHub Actions runner built on act

BetaOpen SourceMIT
sudo apt install github-act-runner
Updated7 months ago
LanguageGo
Setup difficultyModerate
Stars
397

What is github-act-runner?

github-act-runner is a reverse-engineered, GitHub Actions compatible self-hosted runner that uses nektos/act (and later actions-oss/act-cli) to run workflow steps. Unlike the official runner, it works on more systems including FreeBSD and can operate without Docker. It speaks the same protocol as the official runner so it can register with GitHub (repos, organizations, or enterprises) and execute jobs. The runner supports composite actions, service containers (since v0.7.0), node.js actions, and various GitHub Actions features. It can be installed via binary downloads from GitHub releases, a Debian APT repository, or built from source (requires Go 1.24+). The runner is configured with a registration token from GitHub and runs as a background service.

Should you self-host github-act-runner?

github-act-runner scores 48/100 on selfhost.directory (how scoring works) and ranks #23 of 28 in CI/CD. It has 397 GitHub stars.

It shipped 4 stable releases in the past year. The latest, v0.13.0, came out on 23 January 2026. New versions land roughly every 2 weeks.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is jenkins (82/100, 26 703 stars). It scores higher overall, so compare the two before you pick. See github-act-runner vs jenkins side by side.

Features

  • Background service mode
  • Composite actions support
  • Cross-Platform Support
  • Docker actions supportRequires Docker daemon accessible via DOCKER_HOST
  • GitHub Actions protocol compatibility
  • Local execution without GitHub
  • Node.js actions supportRequires node v20 for best compatibility
  • Service containers

github-act-runner README

How to install github-act-runner

Install github-act-runner with Linux

Download and extract the self-hosted runner artifact for your system from GitHub releases, then follow the official documentation (follow the linux instruction if your system isn't listed).

If your system doesn't have bash installed and isn't windows then: | replace | with | ./config.sh | ./github-act-runner configure | ./config.sh remove | ./github-act-runner remove | ./run.sh | ./github-act-runner run

Pre-built binaries for many platforms including Linux, Windows, macOS, FreeBSD, Android

How to configure github-act-runner

  • labelsComma-separated list of runner labels

    Comma-separated list of runner labels

  • nameName for this runner

    Name for this runner

  • runnergroupRunner group to register the runner in

    Runner group to register the runner in

  • tokenRunner registration token from GitHub

    Runner registration token from GitHub

  • urlGitHub repository, organization, or enterprise URL (e.g., https://github.com/user/repo)

    GitHub repository, organization, or enterprise URL (e.g., https://github.com/user/repo)

github-act-runner releases & version history

More in CI/CD

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…