Forgejo selbst hosten - der einfache Weg

Forgejo selbst hosten - der einfache Weg

Yulei Chen - Content-Engineerin bei sliplane.ioYulei Chen
4 min

Forgejo ist eine leichtgewichtige Open-Source Software-Forge. Stell dir ein selbst gehostetes GitHub vor: Git-Hosting, Pull Requests, Issue Tracking, CI/CD mit Forgejo Actions und mehr. Es ist ein Community-getriebener Fork von Gitea, der konsequent frei und open source bleibt.

Sliplane ist eine Managed-Container-Plattform, die Self-Hosting schmerzlos macht. Mit One-Click-Deployment läuft Forgejo in wenigen Minuten - kein Server-Setup, keine Reverse-Proxy-Config, keine Infrastruktur zum Verwalten.

Voraussetzungen

Vor dem Deploy brauchst du einen Sliplane-Account (kostenlose Trial verfügbar).

Quick Start

Sliplane bietet One-Click-Deployment mit Presets.

SliplaneDeploy Forgejo >
  1. Klick auf den Deploy-Button oben
  2. Wähl ein Projekt
  3. Wähl einen Server. Wenn du dich gerade erst angemeldet hast, bekommst du einen 48-Stunden-Trial-Server
  4. Klick auf Deploy!

Über das Preset

Der One-Click-Deploy oben nutzt Sliplanes Forgejo-Preset. Das ist drin:

  • Forgejo 8 Image (codeberg.org/forgejo/forgejo:8) - prüf Codeberg für neuere Versionen
  • Persistenter Storage gemountet auf /data für Repos, Datenbank und Config
  • Healthcheck auf dem Web-UI-Port konfiguriert
  • HTTPS direkt einsatzbereit dank Sliplanes automatischem TLS

Nächste Schritte

Sobald Forgejo läuft, öffne die Domain, die Sliplane dir gibt (z.B. forgejo-xxxx.sliplane.app).

Ersteinrichtung

Beim ersten Besuch zeigt Forgejo eine Installationsseite. Die meisten Einstellungen sind vorkonfiguriert, aber du solltest:

  1. Den Site Title nach Wunsch setzen
  2. Unten auf der Seite einen Administrator Account anlegen
  3. Auf Install Forgejo klicken

Danach bist du eingeloggt und kannst direkt Repositories erstellen.

Konfiguration

Forgejo speichert die Config in /data/gitea/conf/app.ini im Container. Du kannst das Verhalten über Environment-Variablen im Format FORGEJO__section__key anpassen. Zum Beispiel:

VariableBeschreibung
FORGEJO__server__ROOT_URLDie öffentliche URL deiner Instanz
FORGEJO__mailer__ENABLEDE-Mail-Benachrichtigungen aktivieren (true/false)
FORGEJO__service__DISABLE_REGISTRATIONÖffentliche Registrierung deaktivieren, nachdem du deinen Admin-Account erstellt hast

Das komplette Forgejo Configuration Cheat Sheet listet alle Optionen auf.

SSH-Zugang

Das Preset startet Forgejos eingebauten SSH-Server. Wenn du SSH-basierten Git-Zugang brauchst, kannst du das über das Forgejo Admin-Panel oder Environment-Variablen konfigurieren. Für die meisten reicht HTTPS-Cloning direkt mit der Sliplane-Domain.

Logging

Standardmäßig loggt Forgejo nach STDOUT, was super mit Sliplanes eingebautem Log-Viewer funktioniert. Du kannst den Log-Level über die Variable FORGEJO__log__LEVEL auf debug, info, warn oder error setzen. Allgemeine Docker-Log-Tipps findest du in unserem Post how to use Docker logs.

Kostenvergleich

So sieht Self-Hosting von Forgejo auf verschiedenen Plattformen im Vergleich aus:

ProvidervCPU CoresRAMDiskGeschätzte monatliche KostenHinweise
Sliplane22 GB40 GB€9Abrechnung pro Server
Render12 GB40 GB~$35-$45VM Small
Fly.io22 GB40 GB~$20-$25VM + Volume
Railway22 GB40 GB~$15-$66Nutzungsbasiert

FAQ

Kann Forgejo GitHub für mein Team ersetzen?

Für die meisten kleinen bis mittleren Teams, ja. Forgejo bietet Git-Hosting, Pull Requests, Code Review, Issue Tracking, eine Package Registry und CI/CD über Forgejo Actions. Du bekommst nicht GitHubs riesiges Integrations-Ökosystem, aber für den täglichen Entwicklungs-Workflow deckt Forgejo alles Wichtige ab.

Wie deaktiviere ich die öffentliche Registrierung?

Setz die Environment-Variable FORGEJO__service__DISABLE_REGISTRATION auf true und redeploy. Das ist empfehlenswert, nachdem du deinen Admin-Account erstellt und dein Team eingeladen hast.

Wie aktualisiere ich Forgejo?

Änder den Image-Tag in deinen Service-Einstellungen (z.B. von forgejo:8 auf eine neuere Version) und redeploy. Prüf Codeberg für das neueste stabile Release. Forgejo übernimmt Datenbank-Migrationen automatisch beim Start.

Was ist der Unterschied zwischen Forgejo und Gitea?

Forgejo ist ein Hard Fork von Gitea, entstanden 2022 als es in der Gitea-Community Governance-Bedenken gab. Beide teilen die gleiche Codebasis, aber Forgejo wird von einer Community-Organisation betrieben und bleibt konsequent Open Source. Feature-mäßig sind sie sich sehr ähnlich.

Kann ich Repositories von GitHub oder GitLab migrieren?

Ja. Forgejo hat ein eingebautes Migrations-Tool, das Repositories (inklusive Issues, Pull Requests und Labels) von GitHub, GitLab, Gitea und anderen Plattformen importieren kann. Du findest es unter New Migration in der UI.

Host Forgejo jetzt selbst - so einfach!

Sliplane gibt dir alles, was du brauchst, um deine eigene Git-Forge ohne Server-Stress zu betreiben.