Développeur

Script d'installation d'un runner GitHub Actions auto-hébergé

Indiquez votre dépôt et vos labels pour obtenir un script qui installe le runner sous son propre utilisateur et le lance comme service. Vous saisissez le jeton sur votre serveur, pas ici.

Fonctionne entièrement dans votre navigateur — rien de ce que vous saisissez n'est envoyé à nos serveurs.

URL du dépôt ou de l'organisationRemplacez l'exemple par votre adresse. Pour un runner à l'échelle de l'organisation, gardez uniquement l'organisation.

Nom du runnerLabels, séparés par des virgulesUtilisateur Linux

Installer Docker pour les jobs qui en ont besoin

Dépôts privés uniquement. Dans un dépôt public, une pull request venant d'un fork peut exécuter du code sur votre serveur.

Script d'installation

#!/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

Ligne pour votre workflow

runs-on: [self-hosted, vps]

Comment le lancer

Sur GitHub, ouvrez Settings → Actions → Runners → New self-hosted runner et copiez le jeton.
Copiez le script sur votre serveur Debian ou Ubuntu et lancez-le en root : bash install-runner.sh.
Collez le jeton quand le script le demande. Il reste sur votre serveur et ne passe jamais par cette page.
Ajoutez la ligne runs-on à votre workflow.

Guide pas à pas : runner auto-hébergé sur un VPS

Besoin d'un serveur pour le runner ? Offre Small : 4 vCPU, 4 Go de RAM, accès root, 8 $/mois.

Offre Small

Comment ça marche

Un runner auto-hébergé fonctionne sur votre propre machine : il se connecte à GitHub, récupère les jobs et les exécute chez vous. Le script installe les paquets nécessaires, crée un utilisateur Linux distinct, télécharge la dernière version du runner, l'enregistre et configure un service systemd qui survit aux redémarrages. Le script est généré dans votre navigateur : lisez chaque ligne avant de le lancer. Le serveur a seulement besoin d'un accès sortant vers GitHub, aucune IP dédiée n'est requise.

Questions fréquentes

Où trouver le jeton d'enregistrement ?

Dans votre dépôt, ouvrez Settings → Actions → Runners → New self-hosted runner. Le jeton est valable une heure. Pour un runner à l'échelle de l'organisation, suivez le même chemin dans les réglages de l'organisation.

Puis-je utiliser un runner auto-hébergé avec un dépôt public ?

GitHub le déconseille : une pull request venant d'un fork peut exécuter du code sur votre serveur. Réservez les runners auto-hébergés aux dépôts privés.

Le serveur a-t-il besoin d'une IP dédiée ?

Non. Le runner n'établit que des connexions sortantes vers GitHub, une offre sans IP dédiée convient donc. Côté puissance, 4 vCPU et 4 Go de RAM suffisent à la plupart des projets.

Outils similaires

b64

Encodeur/décodeur Base64

Texte et fichiers vers Base64 et retour, option URL-safe.

Générateur d'UUID

UUID v4 et v7 ordonnés dans le temps, en lot.

*/5

Assistant cron

Expliquer une ligne crontab et afficher les prochaines exécutions.

Аa

Translittération

Cyrillique vers latin : normes de passeport et slugs d'URL.

Tous les outils →