diff --git a/runner/README.md b/runner/README.md
new file mode 100644
index 0000000..963407c
--- /dev/null
+++ b/runner/README.md
@@ -0,0 +1,39 @@
+# Runner Gitea (act_runner)
+
+Ce dossier contient une configuration prête à l'emploi pour exécuter un runner Gitea via Docker Compose.
+
+## Prérequis
+
+- Hôte Linux avec Docker et Docker Compose
+- URL de l'instance Gitea et un token d'enregistrement (repo/org/instance)
+
+## Configuration
+
+1. Créez un fichier `.env` depuis l’exemple:
+   - `INSTANCE_URL`: ex. `https://git.4nkweb.com`
+   - `REGISTRATION_TOKEN`: token d'enregistrement
+   - (optionnel) `RUNNER_NAME`, `RUNNER_LABELS` (par défaut `self-hosted,linux`)
+2. Le montage du docker.sock est déjà configuré pour exécuter les jobs en conteneurs.
+
+## Démarrage
+
+```bash
+cd runner
+docker compose up -d
+```
+
+Le runner s'enregistre automatiquement et apparaît dans Settings → Actions → Runners.
+
+## Arrêt / Mise à jour
+
+```bash
+docker compose down
+# Mise à jour d'image
+docker compose pull && docker compose up -d
+```
+
+## Mode éphémère (optionnel)
+
+Activez `GITEA_RUNNER_EPHEMERAL=1` dans `docker-compose.yml` pour des runners jetables.
+
+Réf: Gitea Act Runner — https://docs.gitea.com/usage/actions/act-runner
diff --git a/runner/docker-compose.yml b/runner/docker-compose.yml
new file mode 100644
index 0000000..c443c12
--- /dev/null
+++ b/runner/docker-compose.yml
@@ -0,0 +1,18 @@
+version: "3.8"
+services:
+  runner:
+    image: docker.io/gitea/act_runner:nightly
+    container_name: gitea-act-runner
+    restart: unless-stopped
+    env_file: .env
+    environment:
+      - GITEA_RUNNER_LABELS=${RUNNER_LABELS:-self-hosted,linux}
+      - GITEA_RUNNER_NAME=${RUNNER_NAME:-local-runner}
+      - GITEA_INSTANCE_URL=${INSTANCE_URL}
+      - GITEA_RUNNER_REGISTRATION_TOKEN=${REGISTRATION_TOKEN}
+      # Uncomment to enable ephemeral mode
+      # - GITEA_RUNNER_EPHEMERAL=1
+    volumes:
+      - ./data:/data
+      - /var/run/docker.sock:/var/run/docker.sock
+