x3
4a55944aa8
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
83 lines
1.8 KiB
Markdown
83 lines
1.8 KiB
Markdown
# 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
|
||
```
|