
Gitea selbst hosten – der einfache Weg
Yulei ChenGitea 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.
- Klick auf den Deploy-Button oben
- Wähl ein Projekt
- Wähl einen Server. Wenn du dich gerade erst angemeldet hast, bekommst du einen 48-Stunden-Trial-Server
- 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/giteaImage - Spezifischer Version-Tag (
1.25.5) für Stabilität - prüf Docker Hub für die neueste stabile Version - Persistenter Storage gemountet auf
/datafür Repositories, Datenbank und Config PORT=3000damit Sliplane Traffic an Giteas Web-Interface routet (das Image expose't auch SSH auf Port 22)USER_UIDundUSER_GIDauf1000gesetzt 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:
| Variable | Beschreibung | Beispiel |
|---|---|---|
GITEA__DEFAULT__APP_NAME | Instanzname in der UI | My Git Server |
GITEA__server__ROOT_URL | Volle öffentliche URL deiner Instanz | https://$SLIPLANE_DOMAIN |
GITEA__service__DISABLE_REGISTRATION | Neue Registrierungen deaktivieren | true |
GITEA__mailer__ENABLED | E-Mail-Benachrichtigungen aktivieren | true |
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:
| Variable | Beschreibung | Beispiel |
|---|---|---|
GITEA__log__LEVEL | Log-Verbosity | info, 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_UIDundUSER_GIDzur Volume-Ownership passen (das Preset setzt beides auf1000)
Kostenvergleich
Natürlich kannst du Gitea auch bei anderen Cloud-Providern selbst hosten. Hier ein Preisvergleich der gängigsten Optionen:
| Provider | vCPU Cores | RAM | Disk | Geschätzte monatliche Kosten | Hinweise |
|---|---|---|---|---|---|
| Sliplane | 2 | 2 GB | 40 GB | €9 | Abrechnung pro Server |
| Render | 1 | 2 GB | 40 GB | ~$35-$45 | VM Small |
| Fly.io | 2 | 2 GB | 40 GB | ~$20-$25 | VM + Volume |
| Railway | 2 | 2 GB | 40 GB | ~$15-$66 | Nutzungsbasiert |
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.