Doku: Server-Pfade durch Platzhalter /pfad/zu/docker ersetzen

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
guyg1474andClaude Opus 5.5 committed 2026-10-14 15:38:30 +02:00
1 parent 819219fb2d
commit d61f5be299
1 file changed
+12 -12
+12 -12
View File
@@ -28,13 +28,13 @@ cat ~/.ssh/hcrb_deploy.pub
Den ausgegebenen Schlüssel im Repository unter *Settings → Deploy keys* eintragen (nur Lesezugriff). Dann:
> **Ordner:** Das Projekt liegt in `~/festplatte/dockercontainer/hcrb`. Die Skripte in `deploy/` finden ihren
> **Ordner:** `/pfad/zu/docker` ist ein Platzhalter für den Container-Ordner auf dem Server. Die Skripte in `deploy/` finden ihren
> Ordner selbst – bei einem Umzug muss nur der Pfad in den Befehlen hier angepasst werden.
```bash
mkdir -p ~/festplatte/dockercontainer
GIT_SSH_COMMAND="ssh -i ~/.ssh/hcrb_deploy" git clone git@github.com:guyg1474/hcrb.git ~/festplatte/dockercontainer/hcrb
cd ~/festplatte/dockercontainer/hcrb
mkdir -p /pfad/zu/docker
GIT_SSH_COMMAND="ssh -i ~/.ssh/hcrb_deploy" git clone git@github.com:guyg1474/hcrb.git /pfad/zu/docker/hcrb
cd /pfad/zu/docker/hcrb
git config core.sshCommand "ssh -i ~/.ssh/hcrb_deploy"
chmod +x deploy/*.sh
@@ -72,14 +72,14 @@ Wer die bisherigen Mitglieder, Termine und Logins mitnehmen will, kopiert sie vo
# lokal ausführen
scp data/db.json data/users.json DEIN-USER@SERVER:/tmp/
# auf dem Server
sudo mv /tmp/db.json /tmp/users.json ~/festplatte/dockercontainer/hcrb/data/
sudo chown 1000:1000 ~/festplatte/dockercontainer/hcrb/data/*.json && sudo chmod 600 ~/festplatte/dockercontainer/hcrb/data/*.json
sudo mv /tmp/db.json /tmp/users.json /pfad/zu/docker/hcrb/data/
sudo chown 1000:1000 /pfad/zu/docker/hcrb/data/*.json && sudo chmod 600 /pfad/zu/docker/hcrb/data/*.json
```
## 6. Container starten
```bash
cd ~/festplatte/dockercontainer/hcrb
cd /pfad/zu/docker/hcrb
docker compose up -d --build
docker compose ps # Status sollte nach ca. 30 Sekunden "Up … (healthy)" zeigen
```
@@ -141,7 +141,7 @@ Die NPM-Oberfläche (Port 81) sollte ebenfalls nicht offen im Internet stehen.
```bash
sudo crontab -e
# Zeile hinzufügen:
30 3 * * * /home/DEIN-USER/festplatte/dockercontainer/hcrb/deploy/backup.sh
30 3 * * * /pfad/zu/docker/hcrb/deploy/backup.sh
```
Sichert täglich um 3:30 Uhr `data/` nach `/var/backups/hcrb/` und behält 30 Tage.
@@ -158,7 +158,7 @@ git commit -m "Was geändert wurde"
git push
# auf dem Server
ssh DEIN-USER@SERVER festplatte/dockercontainer/hcrb/deploy/update-docker.sh
ssh DEIN-USER@SERVER /pfad/zu/docker/hcrb/deploy/update-docker.sh
```
`update-docker.sh` holt den neuen Stand, baut den Container neu und startet ihn. Die Daten bleiben unverändert,
@@ -166,7 +166,7 @@ an NPM muss nichts geändert werden.
## Nützliche Befehle auf dem Server
Alle im Ordner `~/festplatte/dockercontainer/hcrb` ausführen:
Alle im Ordner `/pfad/zu/docker/hcrb` ausführen:
| Zweck | Befehl |
| --- | --- |
@@ -178,7 +178,7 @@ Alle im Ordner `~/festplatte/dockercontainer/hcrb` ausführen:
| Rolle ändern | `docker compose exec hcrb npm run user -- role <name> <admin\|mitglied>` |
| Passwort ändern | `docker compose exec hcrb npm run user -- passwd <name>` |
| Benutzer auflisten | `docker compose exec hcrb npm run user -- list` |
| Backup zurückspielen | `docker compose down && sudo tar -xzf /var/backups/hcrb/hcrb-DATUM.tar.gz -C ~/festplatte/dockercontainer/hcrb && sudo chown -R 1000:1000 data && docker compose up -d` |
| Backup zurückspielen | `docker compose down && sudo tar -xzf /var/backups/hcrb/hcrb-DATUM.tar.gz -C /pfad/zu/docker/hcrb && sudo chown -R 1000:1000 data && docker compose up -d` |
## Fehlersuche
@@ -186,5 +186,5 @@ Alle im Ordner `~/festplatte/dockercontainer/hcrb` ausführen:
| --- | --- |
| `port is already allocated` beim Start | Port belegt – in `.env` einen anderen `HCRB_PORT` setzen (Schritt 4) und in NPM nachziehen. |
| NPM zeigt „502 Bad Gateway“ | Container läuft nicht (`docker compose ps`, `docker compose logs`), oder in NPM steht `127.0.0.1` bzw. ein falscher Port – dort die lokale Server-IP eintragen. |
| Container startet neu mit `EACCES … data` | Rechte am Datenordner: `sudo chown -R 1000:1000 ~/festplatte/dockercontainer/hcrb/data` |
| Container startet neu mit `EACCES … data` | Rechte am Datenordner: `sudo chown -R 1000:1000 /pfad/zu/docker/hcrb/data` |
| Nach 10 falschen Passwörtern ist der Login für **alle** gesperrt | Die Seite erkennt die echte Besucher-IP nicht – prüfen, ob `TRUST_PROXY` in `docker-compose.yml` gesetzt ist und der Zugriff über NPM erfolgt. |