Homelab-Dokumentation und Konfigurationsvorlagen

Dokumentation aus dem Wiki uebernommen und um die Dienste auf dem Server erweitert. Alle Anleitungen sind so geschrieben, dass sich der jeweilige Dienst allein daraus neu aufsetzen laesst. docs/ Dienste im Heimnetz (aus dem Wiki, anonymisiert) services/ Dienste auf dem Server mit Konfigurationsvorlagen - matrix-synapse: Homeserver, Postgres, Well-Known-Delegation - coturn: TURN-Relay fuer Anrufe - element-web: Web-Client - wikijs, gitea, nginx Durchgehend anonymisiert: echte Domain durch example.com ersetzt, IP-Adressen und E-Mail-Adressen durch Platzhalter. Konfigurationsdateien liegen nur als .example mit Platzhaltern statt echter Secrets vor. Die Anleitungen halten die Stolpersteine fest, die beim Aufbau tatsaechlich aufgetreten sind, unter anderem: - Synapse verlangt LC_COLLATE=C, sonst startet es nicht - server_name ist nachtraeglich nicht aenderbar -> Delegation noetig - register_new_matrix_user liest conf.d nicht, Secret muss per -k kommen - coturn braucht external-ip, sonst kommen keine Medien durch - Gruppenmitgliedschaft fuer den Zertifikatszugriff wirkt erst beim Neustart - nginx vererbt add_header nicht in location-Bloecke mit eigenen Direktiven
2026-08-31 17:56:02 +00:00
commit 4a55944aa8
32 changed files with 1848 additions and 0 deletions
@@ -0,0 +1,82 @@
+# Gitea: Projekt hochladen & als „GitHub-Seite“ nutzen
+
+In Gitea (https://git.example.com) lässt sich ein Projekt genauso verwalten wie
+auf GitHub: Du legst ein Repository an, pusht lokale Änderungen und nutzt die
+README als Projekt-Startseite.
+
+---
+
+## 1. Repository in Gitea anlegen
+
+1. In Gitea einloggen (https://git.example.com).
+2. Rechts oben auf das **+** bzw. **Neues Repository** klicken.
+3. Werte einstellen:
+   - **Name:** z. B. `ftptui`
+   - **Sichtbarkeit:** öffentlich/private (nach Bedarf)
+   - **README initialisieren:** aktiv (optional)
+4. **Repository erstellen** klicken.
+
+Das Repo ist jetzt unter `https://git.example.com/<benutzer>/<name>` erreichbar.
+
+---
+
+## 2. Lokal einrichten & hochladen (Push)
+
+### Variante A: Neues Projekt, bereits existierendes Repo klonen
+
+```bash
+git clone https://git.example.com/<benutzer>/<name>.git
+cd <name>
+# ... Dateien hinzufügen ...
+git add -A
+git commit -m "Erster Commit"
+git push
+```
+
+### Variante B: Bestehendes lokales Projekt anbinden
+
+```bash
+cd /pfad/zum/projekt
+git init
+git add -A
+git commit -m "Erster Commit"
+git branch -M main
+git remote add origin https://git.example.com/<benutzer>/<name>.git
+git push -u origin main
+```
+
+> Aus der `shell`-Umgebung von `example.com` ist das Repo auch per **SSH**
+> erreichbar: `<E-MAIL>:<benutzer>/<name>.git`
+> (vorher unter **Einstellungen → SSH-Schlüssel** einen öffentlichen Schlüssel hinterlegen).
+
+---
+
+## 3. README als Projekt-Startseite
+
+Die `README.md` im Stammverzeichnis des Repos wird auf der Projektseite in Gitea
+automatisch gerendert – genau wie die Projektseite bei GitHub. Diese Repo-Seite
+folgt dabei **Markdown**.
+
+### README minimal aufbauen
+
+```markdown
+# Projektname
+
+> Kurzbeschreibung in einem Satz.
+
+## Funktionsumfang
+- ...
+
+## Installation
+```bash
+pip install .
+```
+
+## Verwendung
+```bash
+projektbefehl
+```
+
+## Lizenz
+MIT
+```