Gitea selbst hosten – der einfache Weg

Gitea selbst hosten – der einfache Weg

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

Gitea ist ein leichtgewichtiger, selbst gehosteter Git-Service. Stell dir ein eigenes privates GitHub vor - Code-Hosting, Pull Requests, Issue Tracking und CI/CD - alles in einem Paket. GitHub und GitLab sind super, aber die Kosten können für Teams schnell steigen oder es gibt Einschränkungen bei privaten Repos und CI-Minuten.

Sliplane ist eine Managed-Container-Plattform, die Self-Hosting schmerzlos macht. Mit One-Click-Deployment läuft Gitea 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 Gitea >
  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 Gitea-Preset. Das Preset ist für ein sauberes, stabiles Standard-Setup gedacht:

  • Offizielles gitea/gitea Image
  • Spezifischer Version-Tag (1.25.5) für Stabilität - prüf Docker Hub für die neueste stabile Version
  • Persistenter Storage gemountet auf /data für Repositories, Datenbank und Config
  • PORT=3000 damit Sliplane Traffic an Giteas Web-Interface routet (das Image expose't auch SSH auf Port 22)
  • USER_UID und USER_GID auf 1000 gesetzt für korrekte Dateiberechtigungen

Nächste Schritte

Sobald Gitea auf Sliplane läuft, erreichst du es über die Domain, die Sliplane dir gibt (z.B. gitea-xxxx.sliplane.app).

Ersteinrichtung

Beim ersten Besuch zeigt dir Gitea einen Installations-Wizard. Die meisten Defaults passen. Wichtig sind:

  • Site Title: Setz den Namen deiner Instanz
  • Server Domain: Ist schon auf deine Sliplane-Domain gesetzt
  • Administrator Account: Erstell deinen Admin-User unten auf der Seite

Danach klick auf Install Gitea und los geht's.

Wichtige Environment-Variablen

Du kannst Giteas Verhalten über Environment-Variablen anpassen. Gitea nutzt das GITEA__ Prefix mit Section- und Key-Namen. Zum Beispiel, um den App-Namen zu ändern:

VariableBeschreibungBeispiel
GITEA__DEFAULT__APP_NAMEInstanzname in der UIMy Git Server
GITEA__server__ROOT_URLVolle öffentliche URL deiner Instanzhttps://$SLIPLANE_DOMAIN
GITEA__service__DISABLE_REGISTRATIONNeue Registrierungen deaktivierentrue
GITEA__mailer__ENABLEDE-Mail-Benachrichtigungen aktivierentrue

Die vollständige Liste der Config-Optionen findest du im Gitea Configuration Cheat Sheet.

Logging

Standardmäßig loggt Gitea nach STDOUT, was perfekt mit Sliplanes eingebautem Log-Viewer funktioniert. Du kannst das Log-Level über Environment-Variablen anpassen:

VariableBeschreibungBeispiel
GITEA__log__LEVELLog-Verbosityinfo, debug, warn

Allgemeine Docker-Log-Tipps findest du in unserem Post how to use Docker logs.

Troubleshooting

Wenn du auf Probleme stößt, setz das Log-Level auf debug mit GITEA__log__LEVEL=debug und redeploy. Das gibt dir detaillierten Output darüber, was Gitea macht. Häufige Probleme:

  • 502-Fehler direkt nach dem Deploy: Gitea initialisiert sich vielleicht noch. Gib ihm eine Minute
  • Permission-Fehler: Achte drauf, dass USER_UID und USER_GID zur Volume-Ownership passen (das Preset setzt beides auf 1000)

Kostenvergleich

Natürlich kannst du Gitea auch bei anderen Cloud-Providern selbst hosten. Hier ein Preisvergleich der gängigsten Optionen:

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

Wofür kann ich Gitea nutzen?

Gitea gibt dir Code-Hosting mit Git-Repositories, Pull Requests, Issue Tracking, eine Package Registry und sogar eingebautes CI/CD mit Gitea Actions (kompatibel mit GitHub Actions). Es ist eine vollständige Entwicklungsplattform, die dir gehört und die du kontrollierst.

Wie deaktiviere ich die öffentliche Registrierung?

Setz die Environment-Variable GITEA__service__DISABLE_REGISTRATION=true und redeploy. Das beschränkt die Account-Erstellung auf Admins - empfehlenswert, wenn du eine private Instanz betreibst.

Wie aktualisiere ich Gitea?

Änder den Image-Tag in deinen Service-Einstellungen auf die neuere Version und redeploy. Prüf Docker Hub für die neueste stabile Version. Gitea handhabt Datenbank-Migrationen automatisch beim Start.

Gibt es Alternativen zu Gitea?

Ja. Beliebte Self-Hosting-Optionen sind Forgejo (ein Gitea-Fork mit Fokus auf Community-Governance), GitLab CE (feature-reich, aber schwergewichtiger) und Gogs (minimal und schnell). Als Managed Services gibt es GitHub, GitLab.com und Bitbucket.

Kann ich Gitea Actions für CI/CD nutzen?

Ja. Gitea Actions ist kompatibel mit GitHub Actions Workflows. Du musst einen Act Runner aufsetzen - den kannst du als separaten Service auf Sliplane deployen und über Sliplanes internes Netzwerk mit deiner Gitea-Instanz verbinden.

Host Gitea jetzt selbst – so einfach!

Sliplane gibt dir alles, was du brauchst, um deinen eigenen Git-Service ohne Server-Stress zu betreiben.