d211bed5e4
- docker-compose.yml aktualisiert fuer Proxmox Bare Metal - Security-Optionen (apparmor/seccomp) - Health-Check - Resource Limits - ROOT_URL fuer externen Zugriff via DuckDNS - README.md mit Architektur und Quick Start - TROUBLESHOOTING.md mit Problemloesungen - nginx-gitea.conf fuer VPS Reverse Proxy Deployment: https://eckardt-vault.duckdns.org/git/ 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
154 lines
3.1 KiB
Markdown
154 lines
3.1 KiB
Markdown
# Gitea Troubleshooting
|
|
|
|
## Haeufige Probleme und Loesungen
|
|
|
|
### 1. Container startet nicht
|
|
|
|
**Symptom:** `docker compose up -d` startet, aber Container laeuft nicht
|
|
|
|
**Loesung:**
|
|
```bash
|
|
# Logs pruefen
|
|
docker logs gitea
|
|
|
|
# Oft: Berechtigungsprobleme
|
|
docker exec gitea ls -la /data
|
|
|
|
# Oder Volume-Probleme
|
|
docker volume inspect gitea_gitea-data
|
|
```
|
|
|
|
### 2. "Permission denied" Fehler auf Proxmox
|
|
|
|
**Symptom:** `socketpair() failed (13: Permission denied)`
|
|
|
|
**Ursache:** Proxmox VE Bare Metal hat strikte Kernel-Hardening
|
|
|
|
**Loesung:** security_opt in docker-compose.yml hinzufuegen:
|
|
```yaml
|
|
security_opt:
|
|
- apparmor=unconfined
|
|
- seccomp=unconfined
|
|
```
|
|
|
|
### 3. Falscher Datenbanktyp bei Ersteinrichtung
|
|
|
|
**Symptom:** Fehlermeldung "unable to open tcp connection with host 'localhost:3306'"
|
|
|
|
**Loesung:**
|
|
- Dropdown "Datenbanktyp" auf **SQLite3** aendern
|
|
- NICHT MSSQL oder MySQL auswaehlen
|
|
|
|
### 4. Externer Zugriff funktioniert nicht
|
|
|
|
**Symptom:** https://eckardt-vault.duckdns.org/git/ nicht erreichbar
|
|
|
|
**Checkliste:**
|
|
```bash
|
|
# 1. Pruefen ob Gitea laeuft
|
|
docker ps | grep gitea
|
|
|
|
# 2. Pruefen ob Port offen ist (auf Proxmox)
|
|
curl http://localhost:3000
|
|
|
|
# 3. WireGuard Tunnel pruefen (auf VPS)
|
|
ping 10.0.0.2
|
|
|
|
# 4. nginx Config testen (auf VPS)
|
|
cd C:\nginx && nginx.exe -t
|
|
|
|
# 5. nginx neu starten (auf VPS)
|
|
net stop nginx && net start nginx
|
|
```
|
|
|
|
### 5. SSH Clone funktioniert nicht
|
|
|
|
**Symptom:** `git clone ssh://...` schlaegt fehl
|
|
|
|
**Loesung:**
|
|
```bash
|
|
# SSH Key in Gitea hinzufuegen
|
|
# Settings -> SSH/GPG Keys -> Add Key
|
|
|
|
# Public Key anzeigen
|
|
cat ~/.ssh/id_ed25519.pub
|
|
|
|
# SSH Verbindung testen
|
|
ssh -T -p 2222 git@192.168.178.111
|
|
```
|
|
|
|
### 6. Health-Check schlaegt fehl
|
|
|
|
**Symptom:** Container Status "unhealthy"
|
|
|
|
**Loesung:**
|
|
```bash
|
|
# Health-Endpoint manuell testen
|
|
docker exec gitea curl -f http://localhost:3000/api/healthz
|
|
|
|
# Falls curl nicht installiert:
|
|
docker exec gitea wget -q --spider http://localhost:3000/api/healthz
|
|
```
|
|
|
|
### 7. Backup schlaegt fehl
|
|
|
|
**Symptom:** Backup-Script gibt Fehler aus
|
|
|
|
**Loesung:**
|
|
```bash
|
|
# Volume-Pfad pruefen
|
|
docker volume inspect gitea_gitea-data
|
|
|
|
# Manuelles Backup erstellen
|
|
docker exec gitea gitea dump -c /data/gitea/conf/app.ini
|
|
```
|
|
|
|
### 8. Nach Update: Gitea startet nicht mehr
|
|
|
|
**Symptom:** Nach `docker compose pull` funktioniert nichts mehr
|
|
|
|
**Loesung:**
|
|
```bash
|
|
# Alte Version wiederherstellen
|
|
docker compose down
|
|
docker image tag gitea/gitea:latest gitea/gitea:backup
|
|
docker pull gitea/gitea:1.21 # oder gewuenschte Version
|
|
docker compose up -d
|
|
|
|
# Oder: Datenbank-Migration manuell ausfuehren
|
|
docker exec gitea gitea migrate
|
|
```
|
|
|
|
## Diagnose-Befehle
|
|
|
|
```bash
|
|
# Container Status
|
|
docker ps -a | grep gitea
|
|
|
|
# Container Ressourcen
|
|
docker stats gitea --no-stream
|
|
|
|
# Netzwerk pruefen
|
|
docker network inspect gitea_gitea-net
|
|
|
|
# Alle Logs (letzte 100 Zeilen)
|
|
docker logs gitea --tail 100
|
|
|
|
# Live Logs
|
|
docker logs gitea -f
|
|
|
|
# In Container einloggen
|
|
docker exec -it gitea /bin/sh
|
|
|
|
# Gitea Version
|
|
docker exec gitea gitea --version
|
|
|
|
# Gitea Admin-Befehle
|
|
docker exec gitea gitea admin user list
|
|
```
|
|
|
|
## Kontakt / Weitere Hilfe
|
|
|
|
- Gitea Dokumentation: https://docs.gitea.io/
|
|
- Gitea GitHub Issues: https://github.com/go-gitea/gitea/issues
|