Files

T

x3 4a55944aa8 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

1.8 KiB

Raw Blame History

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

In Gitea einloggen (https://git.example.com).
Rechts oben auf das + bzw. Neues Repository klicken.
Werte einstellen:
- Name: z. B. ftptui
- Sichtbarkeit: öffentlich/private (nach Bedarf)
- README initialisieren: aktiv (optional)
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

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

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

# Projektname

> Kurzbeschreibung in einem Satz.

## Funktionsumfang
- ...

## Installation
```bash
pip install .

Verwendung

projektbefehl

Lizenz

MIT

1.8 KiB Raw Blame History Unescape Escape