Ontwikkelaar

Installatiescript voor een self-hosted GitHub Actions-runner

Vul je repository en labels in en krijg een script dat de runner onder een eigen gebruiker installeert en als service start. Het token voer je in op je server, niet hier.

Werkt volledig in je browser — niets van wat je invoert wordt naar onze servers gestuurd.

URL van de repository of organisatieVervang het voorbeeld door je eigen adres. Voor een runner voor de hele organisatie laat je alleen de organisatie staan.

Naam van de runnerLabels, gescheiden door komma'sLinux-gebruiker

Docker installeren voor jobs die het nodig hebben

Alleen voor privé-repository's. In een openbare kan een pull request uit een fork code op je server uitvoeren.

Installatiescript

#!/usr/bin/env bash
# Installs a self-hosted GitHub Actions runner as a systemd service (Debian, Ubuntu).
# Run as root: bash install-runner.sh
set -euo pipefail

REPO_URL="https://github.com/your-org/your-repo"
RUNNER_NAME="vps-runner-1"
RUNNER_LABELS="vps"
RUNNER_USER="runner"
RUNNER_DIR="/home/$RUNNER_USER/actions-runner"

[ "$(id -u)" -eq 0 ] || { echo "Run this script as root." >&2; exit 1; }
command -v apt-get >/dev/null || { echo "This script supports Debian and Ubuntu only." >&2; exit 1; }
case "$(uname -m)" in
  x86_64) ARCH=x64 ;;
  aarch64) ARCH=arm64 ;;
  *) echo "Unsupported CPU: $(uname -m)" >&2; exit 1 ;;
esac
[ ! -f "$RUNNER_DIR/.runner" ] || { echo "A runner is already configured in $RUNNER_DIR." >&2; exit 1; }

read -rsp "Registration token from GitHub: " RUNNER_TOKEN; echo
[ -n "$RUNNER_TOKEN" ] || { echo "The token is empty." >&2; exit 1; }

apt-get update -y
apt-get install -y curl tar ca-certificates
id "$RUNNER_USER" >/dev/null 2>&1 || useradd -m -s /bin/bash "$RUNNER_USER"

# Latest runner release
VERSION="$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/actions/runner/releases/latest | sed 's|.*/tag/v||')"
FILE="actions-runner-linux-$ARCH-$VERSION.tar.gz"
as_runner() { runuser -u "$RUNNER_USER" -- env HOME="/home/$RUNNER_USER" "$@"; }
as_runner mkdir -p "$RUNNER_DIR"
cd "$RUNNER_DIR"
as_runner curl -fsSL -o "$FILE" "https://github.com/actions/runner/releases/download/v$VERSION/$FILE"
as_runner tar xzf "$FILE"
rm -f "$FILE"
./bin/installdependencies.sh

# Register with GitHub and start as a service
as_runner ./config.sh --unattended --url "$REPO_URL" --token "$RUNNER_TOKEN" --name "$RUNNER_NAME" --labels "$RUNNER_LABELS" --replace
./svc.sh install "$RUNNER_USER"
./svc.sh start
./svc.sh status --no-pager

Regel voor je workflow

runs-on: [self-hosted, vps]

Zo start je het

Open op GitHub Settings → Actions → Runners → New self-hosted runner en kopieer het token.
Kopieer het script naar je Debian- of Ubuntu-server en start het als root: bash install-runner.sh.
Plak het token als het script erom vraagt. Het blijft op je server en gaat nooit via deze pagina.
Zet de regel runs-on in je workflow.

Stap-voor-stap-gids: self-hosted runner op een VPS

Een server nodig voor de runner? Pakket Small: 4 vCPU, 4 GB RAM, root-toegang, $ 8 per maand.

Pakket Small

Zo werkt het

Een self-hosted runner werkt op je eigen machine: hij maakt zelf verbinding met GitHub, haalt jobs op en voert ze daar uit. Het script installeert de benodigde pakketten, maakt een aparte Linux-gebruiker aan, downloadt de nieuwste runner-versie, registreert die en richt een systemd-service in die herstarts overleeft. Het script wordt in je browser gemaakt, dus lees elke regel voordat je het start. De server heeft alleen uitgaande toegang tot GitHub nodig, een dedicated IP is niet vereist.

Veelgestelde vragen

Waar vind ik het registratietoken?

Open in je repository Settings → Actions → Runners → New self-hosted runner. Het token is een uur geldig. Voor een runner voor de hele organisatie volg je hetzelfde pad in de instellingen van de organisatie.

Kan ik een self-hosted runner gebruiken met een openbare repository?

GitHub raadt het af: een pull request uit een fork kan code op je server uitvoeren. Gebruik self-hosted runners met privé-repository's.

Heeft de server een dedicated IP nodig?

Nee. De runner maakt alleen uitgaande verbindingen met GitHub, dus een pakket zonder dedicated IP volstaat. Qua vermogen hebben de meeste projecten genoeg aan 4 vCPU en 4 GB RAM.

Vergelijkbare tools

b64

Base64-encoder/decoder

Tekst en bestanden naar Base64 en terug, URL-safe optie.

UUID-generator

UUID v4 en tijdgeordende v7, in bulk.

*/5

Cron-hulp

Leg een crontab-regel uit en toon de volgende runs.

Аa

Transliteratie

Cyrillisch naar Latijn: paspoortnormen en URL-slugs.

Alle tools →