From 334a5e35264bf57f1f3586bd78364a5b1d704876 Mon Sep 17 00:00:00 2001
From: Citali <git@fellies.email>
Date: Wed, 11 Feb 2026 12:25:57 +0100
Subject: [PATCH] chore(ci): add gitea actions runner compose setup

---
 .env.gitea-runner.example       |  4 ++++
 .gitignore                      |  1 +
 README.md                       |  8 ++++++++
 docker-compose.gitea-runner.yml | 13 +++++++++++++
 4 files changed, 26 insertions(+)
 create mode 100644 .env.gitea-runner.example
 create mode 100644 docker-compose.gitea-runner.yml

diff --git a/.env.gitea-runner.example b/.env.gitea-runner.example
new file mode 100644
index 0000000..d7a7338
--- /dev/null
+++ b/.env.gitea-runner.example
@@ -0,0 +1,4 @@
+GITEA_INSTANCE_URL="https://git.example.com"
+GITEA_RUNNER_REGISTRATION_TOKEN="replace-with-runner-registration-token"
+GITEA_RUNNER_NAME="cms-runner"
+GITEA_RUNNER_LABELS="ubuntu-latest:docker://node:20-bookworm"
diff --git a/.gitignore b/.gitignore
index df95ee5..499c639 100644
--- a/.gitignore
+++ b/.gitignore
@@ -24,6 +24,7 @@ test-results
 !.env.example
 !.env.staging.example
 !.env.production.example
+!.env.gitea-runner.example
 
 # prisma
 packages/db/prisma/dev.db*
diff --git a/README.md b/README.md
index df0ed54..2828d3d 100644
--- a/README.md
+++ b/README.md
@@ -119,12 +119,20 @@ Environment examples:
 
 - `.env.staging.example`
 - `.env.production.example`
+- `.env.gitea-runner.example`
 
 Notes:
 
 - `dev` remains your local non-docker Bun workflow.
 - Staging and production compose files are templates and still require real secrets, registry strategy, and deployment host wiring.
 
+Gitea Actions runner compose (self-hosted):
+
+```bash
+cp .env.gitea-runner.example .env.gitea-runner
+docker compose --env-file .env.gitea-runner -f docker-compose.gitea-runner.yml up -d
+```
+
 ## Changelog
 
 - Changelog file: `CHANGELOG.md`
diff --git a/docker-compose.gitea-runner.yml b/docker-compose.gitea-runner.yml
new file mode 100644
index 0000000..49f0755
--- /dev/null
+++ b/docker-compose.gitea-runner.yml
@@ -0,0 +1,13 @@
+services:
+  gitea-runner:
+    image: gitea/act_runner:latest
+    container_name: cms-gitea-runner
+    restart: unless-stopped
+    environment:
+      GITEA_INSTANCE_URL: "${GITEA_INSTANCE_URL}"
+      GITEA_RUNNER_REGISTRATION_TOKEN: "${GITEA_RUNNER_REGISTRATION_TOKEN}"
+      GITEA_RUNNER_NAME: "${GITEA_RUNNER_NAME:-cms-runner}"
+      GITEA_RUNNER_LABELS: "${GITEA_RUNNER_LABELS:-ubuntu-latest:docker://node:20-bookworm}"
+    volumes:
+      - ./runner-data:/data
+      - /var/run/docker.sock:/var/run/docker.sock