Forgejo vs Gitea (2026): Unterschiede & Actions Runner
Forgejo v17 vs Gitea v28 im Vergleich: Governance, GPL vs MIT, LTS-Support, Wechselgründe und getestetes Docker Compose mit Forgejo Runner v13.

Im ersten Jahr nach dem Forgejo-Fork Ende 2022 waren beide Projekte fast deckungsgleich. Ein einfacher Image-Tag-Wechsel reichte. Das ist vorbei. Seit dem Hard Fork 2024 haben sich Lizenz, Versionsnummern, LTS-Zusagen und Upgrade-Pfade sauber getrennt.
In der selfh.st-Community-Umfrage 2026 hat Forgejo Gitea erstmals überholt. Trotzdem hängt die richtige Wahl an deinen konkreten Anforderungen an eine Git-Forge und nicht an Foren-Stimmung. Hier ist der sachliche Vergleich zwischen Forgejo v17 und Gitea v28 Ende 2026, gefolgt von einem getesteten Docker-Compose-Setup mit Forgejo 17.0.2 und dem nativen Forgejo Runner (v13.2.2).
Forgejo vs Gitea Ende 2026
Beide sind schlanke Go-Binaries mit Pull Requests, Issues, Paket-/Container-Registry und eingebauter Actions-CI. Beide liegen im Leerlauf um 100 MB RAM (codeberg.org/forgejo/forgejo:17 brauchte bei mir 104,5 MiB auf Docker 29.2) und damit etwa 20x unter GitLab. Die echten Unterschiede:
| Bereich | Forgejo | Gitea |
|---|---|---|
| Aktuelles Release (Nov. 2026) | v17.0.2 (18. Nov. 2026) | v28.3.0 (1.-Präfix ab 28.0 gestrichen) |
| LTS-Zweig | Ja (v15.0.12 bis 15. Juli 2027) | Keine dokumentierte LTS-Linie |
| Lizenz | GPL-3.0-or-later (ab v9.0) | MIT |
| Governance | Community-geführt unter dem gemeinnützigen Codeberg e.V. | CommitGo, Inc. (kommerziell) + 6er-TOC (3 Firma, 3 gewählt) |
| Bezahlte Enterprise-Edition | Keine; alle Features offen | Bezahlte Enterprise-Tarife & Gitea Cloud |
| CI / Actions | Forgejo Actions + forgejo-runner v13 (hohe Kompatibilität, Fokus auf Unabhängigkeit) |
Gitea Actions + act_runner (zielt eng auf GitHub-Actions-Parität) |
| ActivityPub-Föderation | Aktiv in Entwicklung (experimentell, föderierte Stars laufen) | Nicht dokumentiert |
| Direkter Wechsel von Gitea | Nur bis Gitea 1.22; neuere Versionen per API-Migration | k. A. |
Warum viele Self-Hoster zu Forgejo wechseln
Drei handfeste Gründe treiben den Wechsel, und nur einer davon ist Governance:
- Planbare LTS-Releases. Forgejo bringt jedes Quartal ein stabiles Release und macht das erste Release jedes Jahres zu einem 15-Monats-LTS (aktuell v15.0.x bis Juli 2027). Für Homelabs und kleine Teams, die Sicherheits-Updates ohne vierteljährliche Breaking Changes wollen, ist das Gold wert.
- Kein Paywall-Drift. Als Gitea Ltd (heute CommitGo, Inc.) 2022 Marken und kommerziellen Betrieb übernahm, wuchs die Sorge vor abwandernden Enterprise-Features. Mit GPL-3.0-or-later unter einem gemeinnützigen deutschen Verein ist dieses Risiko vom Tisch.
- Schnelleres Security-Hardening. Forgejo zieht Sicherheits-Defaults zügig an (v17.0.2 verschärfte gerade SSH-Key-Matching, Scoped-Token-Feeds und PR-Secret-Zugriffe).
Wann bleibt Gitea sinnvoller? Wenn deine Rechtsabteilung GPL-3.0 ausschließt, ihr einen kommerziellen SLA-Vertrag braucht oder extrem enge GitHub-Actions-Parität über act_runner verlangt.
Lässt sich Gitea noch direkt durch das Forgejo-Image ersetzen?
Nur bis Gitea 1.22. Da die Datenbank-Migrationen nach dem Hard Fork auseinanderliefen, scheitert Forgejo 17 an einer Gitea-28-Datenbank. Für aktuelle Gitea-Instanzen startest du ein frisches Forgejo und importierst Repos samt Issues und PRs über Forgejos eingebauten Gitea-API-Migrator.
Forgejo 17 + PostgreSQL + Forgejo Runner in Docker
Falls du lieber eine getrennte CI mit kompakter YAML-Syntax willst, bleibt unser Forgejo + Woodpecker CI Guide (auf Englisch) eine gute Alternative. Für integrierte GitHub-ähnliche .forgejo/workflows/-Pipelines ist hier der getestete Stack mit codeberg.org/forgejo/forgejo:17 (17.0.2) und data.forgejo.org/forgejo/runner:13 (v13.2.2).
Eine Stolperfalle aus meinem Test: Auf data.forgejo.org gibt es kein :latest-Tag für den Runner (runner:latest liefert not found). Pinne immer die Major-Version (:13).
Schritt 1: Runner-Verzeichnis vorbereiten
Der Runner läuft ohne Root-Rechte (uid 1000). Erstelle das Verzeichnis, erzeuge die Standard-Konfig und setze die Rechte:
mkdir -p forgejo-stack/runner-data/.cache
cd forgejo-stack
docker run --rm data.forgejo.org/forgejo/runner:13 \
forgejo-runner generate-config > runner-data/config.yml
sudo chown -R 1000:1000 runner-dataSchritt 2: compose.yaml anlegen
Dieser Stack startet Forgejo 17, PostgreSQL 19 (mit dem seit PG 18 nötigen /var/lib/postgresql-Mount, siehe PostgreSQL 19 Guide), einen isolierten Docker-in-Docker-Daemon für Job-Container und den Forgejo Runner. So bleiben CI-Jobs vom Host-Docker-Socket getrennt.
services:
db:
image: postgres:19-alpine
container_name: forgejo-db
restart: unless-stopped
environment:
POSTGRES_USER: forgejo
POSTGRES_PASSWORD: starkes-passwort-einsetzen
POSTGRES_DB: forgejo
volumes:
- pgdata:/var/lib/postgresql
healthcheck:
test: ["CMD-SHELL", "pg_isready -U forgejo"]
interval: 5s
timeout: 5s
retries: 5
networks:
- forgejo_net
forgejo:
image: codeberg.org/forgejo/forgejo:17
container_name: forgejo
restart: unless-stopped
depends_on:
db:
condition: service_healthy
environment:
USER_UID: 1000
USER_GID: 1000
FORGEJO__database__DB_TYPE: postgres
FORGEJO__database__HOST: db:5432
FORGEJO__database__NAME: forgejo
FORGEJO__database__USER: forgejo
FORGEJO__database__PASSWD: starkes-passwort-einsetzen
FORGEJO__actions__ENABLED: "true"
FORGEJO__actions__DEFAULT_ACTIONS_URL: "https://data.forgejo.org"
volumes:
- ./forgejo-data:/data
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- "127.0.0.1:3000:3000"
- "2222:22"
networks:
- forgejo_net
docker-dind:
image: docker:dind
container_name: forgejo-dind
restart: unless-stopped
privileged: true
command: ["dockerd", "-H", "tcp://0.0.0.0:2375", "--tls=false"]
networks:
- runner_net
runner:
image: data.forgejo.org/forgejo/runner:13
container_name: forgejo-runner
restart: unless-stopped
depends_on:
- docker-dind
- forgejo
user: "1000:1000"
environment:
DOCKER_HOST: tcp://docker-dind:2375
volumes:
- ./runner-data:/data
command: ["forgejo-runner", "daemon", "--config", "/data/config.yml"]
networks:
- forgejo_net
- runner_net
volumes:
pgdata:
networks:
forgejo_net:
runner_net:Starte zuerst Datenbank und Forgejo:
docker compose up -d db forgejoÖffne http://127.0.0.1:3000, schließe den kurzen Installer ab und lege deinen Admin-Nutzer an.
Schritt 3: Runner registrieren und starten
Hole dir unter Website-Administration -> Actions -> Runners -> Neuen Runner erstellen das Token und registriere den Runner einmalig:
docker compose run --rm runner forgejo-runner register \
--no-interactive \
--instance http://forgejo:3000 \
--token DEIN_TOKEN_HIER \
--name homelab-runner \
--labels "docker:docker://node:22-bookworm,ubuntu-latest:docker://catthehacker/ubuntu:act-latest"Danach DinD und Runner starten:
docker compose up -d docker-dind runner
docker compose logs -f runnerDer Runner meldet sich jetzt als Idle in Forgejo.
Schritt 4: Workflow testen
Lege .forgejo/workflows/ci.yml in einem Repo an:
name: Build check
on: [push, pull_request]
jobs:
test:
runs-on: docker
steps:
- uses: actions/checkout@v4
- name: Check environment
run: |
node -v
ls -laDank FORGEJO__actions__DEFAULT_ACTIONS_URL=https://data.forgejo.org zieht actions/checkout@v4 direkt von Forgejos gepflegtem Mirror ohne GitHub-Abhängigkeit.
Praxistipps für den Betrieb
- Für maximale Ruhe das LTS-Tag pinnen. Nutze
codeberg.org/forgejo/forgejo:15statt:17, wenn du reine Sicherheits-Updates ohne vierteljährliche Änderungen bevorzugst. - Passwörter auslagern. Pack das Postgres-Passwort in eine
.env-Datei oder Docker Compose Secrets (auf Englisch). - Sowohl Postgres als auch
./forgejo-datasichern. Git-Repos liegen im Dateisystem, Issues und PRs in Postgres — automatisierbar z. B. mit Zerobyte und Restic. - HTTPS per Reverse Proxy vorschalten. Terminiere TLS über Caddy oder Traefik und passe
ROOT_URLan deine Domain an.
Fazit
Wer 2026 einen neuen Self-Hosted-Git-Server fürs Homelab oder ein kleines Team aufsetzt, fährt mit Forgejo besser: gleicher ~100-MB-Footprint wie Gitea, echter LTS-Zweig, GPL-3.0-Absicherung und in zehn Minuten laufende Actions-CI. Gitea bleibt erste Wahl, wenn MIT-Lizenz oder kommerzieller Support durch CommitGo Pflicht sind.
Häufige Fragen (FAQ)
Laufen bestehende GitHub-Actions-Workflows in Forgejo Actions?
Die meisten einfachen Workflows (Checkout, Node/Python/Go-Tests, Docker-Builds) laufen mit minimalen oder keinen Änderungen. Komplexere Workflows mit GitHub-spezifischen APIs oder reinen github.com-Actions brauchen teils Anpassungen oder volle URLs bei uses:.
Warum schlägt docker compose mit runner:latest not found fehl?
Forgejo Runner veröffentlicht bewusst kein :latest-Tag auf data.forgejo.org, damit automatische Pulls keine Breaking Changes überspringen. Pinne immer eine Hauptversion wie data.forgejo.org/forgejo/runner:13.
Reicht SQLite statt PostgreSQL für Forgejo?
Ja, für Einzelentwickler mit ein paar Dutzend Repositories läuft SQLite sauber und spart einen Container. Sobald mehrere Personen parallel pushen oder Actions-Logs wachsen, verhindert PostgreSQL Lock-Fehler.
Hat diese Anleitung bei dir funktioniert?
Brauchst du Hilfe bei Astro, VPS oder einer Self-hosted-App? Services ansehen →


