homelab/docs/10-gitea.md

10 · Gitea Installation

Datum: 2026-03-20

---

Was wurde installiert

• Gitea (gitea/gitea:latest) — Self-hosted Git-Service
• PostgreSQL 16 (postgres:16-alpine) — Datenbank für Gitea
• Beide Komponenten auf rnk-wrk01 (nodeSelector)

---

Manifest-Dateien

~/homelab/k8s/gitea/
  kustomization.yaml
  namespace.yaml
  secret.yaml          # DB- + Admin-Passwort (nicht ins Git!)
  pvc.yaml             # gitea-data (10Gi) + gitea-postgres (2Gi) via Longhorn
  postgres.yaml        # Deployment + ClusterIP Service
  deployment.yaml      # Gitea Deployment mit initContainer
  service.yaml         # gitea-web (ClusterIP) + gitea-ssh (LoadBalancer)
  ingress.yaml         # Traefik HTTP Ingress

---

Ausgeführte Befehle

mkdir -p ~/homelab/k8s/gitea
# ... alle YAML-Dateien erstellt ...

kubectl apply -k ~/homelab/k8s/gitea/

kubectl wait deployment/gitea-postgres -n gitea --for=condition=Available --timeout=120s
kubectl wait deployment/gitea -n gitea --for=condition=Available --timeout=180s

# Admin-User anlegen (muss als git-User ausgeführt werden, nicht root)
kubectl exec -n gitea deployment/gitea -- su git -c "gitea admin user create \
  --username admin \
  --password '<passwort>' \
  --email admin@homelab.local \
  --admin"

---

Troubleshooting

Problem: Postgres CrashLoopBackOff

Fehler:

initdb: error: directory "/var/lib/postgresql/data" exists but is not empty
initdb: detail: It contains a lost+found directory, perhaps due to it being a mount point.

Ursache: Longhorn-Volume enthält lost+found im Root — Postgres kann kein initdb durchführen wenn das Verzeichnis nicht leer ist.

Fix: PGDATA auf Unterverzeichnis setzen:

env:
  - name: PGDATA
    value: /var/lib/postgresql/data/pgdata

In postgres.yaml dauerhaft eingetragen.

Problem: Gitea läuft nicht als root

Fehler:

Gitea is not supposed to be run as root.

Fix: su git -c "gitea ..." statt direktem Aufruf:

kubectl exec -n gitea deployment/gitea -- su git -c "gitea admin user create ..."

---

IP-Adressen & Zugang

Service	Adresse	Protokoll
Web-UI	http://gitea.192.168.11.180.nip.io	HTTP via Traefik
SSH	192.168.11.182:22	TCP (MetalLB)
Postgres	ClusterIP intern	TCP 5432

MetalLB IP: 192.168.11.182 (SSH)

---

Konfiguration

Parameter	Wert
GITEA__server__DOMAIN	gitea.192.168.11.180.nip.io
GITEA__server__ROOT_URL	http://gitea.192.168.11.180.nip.io
GITEA__security__INSTALL_LOCK	true (kein Setup-Wizard)
TZ	Europe/Vienna
Datenbank	PostgreSQL 16
Node	rnk-wrk01 (beide Pods)

---

Ergebnis

NAME                                  READY   STATUS    RESTARTS
pod/gitea-5dddddf8bd-hg8nt            1/1     Running   0
pod/gitea-postgres-75895d77ff-h6h55   1/1     Running   0

NAME                     TYPE           CLUSTER-IP     EXTERNAL-IP
service/gitea-postgres   ClusterIP      10.43.146.54   <none>
service/gitea-ssh        LoadBalancer   10.43.27.136   192.168.11.182
service/gitea-web        ClusterIP      10.43.166.44   <none>

NAME                    CLASS     HOSTS                         ADDRESS
ingress/gitea-web       traefik   gitea.192.168.11.180.nip.io   192.168.11.180

---

Admin-Passwort gesetzt (2026-03-20)

Admin-Passwort nach Installation auf einheitliches Homelab-Passwort gesetzt.

Problem: Nach change-password via CLI erzwingt Gitea eine Passwortänderung im Browser (must_change_password=true).

Fix:

kubectl exec -n gitea deployment/gitea -- su git -c \
  "gitea admin user change-password --username admin \
   --password 'bmw520AUDI' --must-change-password=false"

k8s Secret und secret.yaml ebenfalls aktualisiert:

kubectl patch secret gitea-secret -n gitea \
  --type='json' \
  -p='[{"op":"replace","path":"/data/admin-password","value":"<base64>"}]'

Verifikation:

curl -s -o /dev/null -w "%{http_code}" \
  http://gitea.192.168.11.180.nip.io/api/v1/user \
  -u admin:bmw520AUDI
# → 200 ✓

---

Nächste Schritte

• SSH-Key für lokale Entwicklung hinterlegen
• Repositories anlegen / migrieren
• Ggf. Gitea Actions aktivieren (CI/CD)
• Backup-Strategie für Longhorn-Volumes festlegen