Document /opt/stacks/kochbuch as stack location

Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
Kyle Dammann
2026-10-30 22:47:42 +01:00
co-authored by Claude Opus 5.5
parent 122d46fdc1
commit ffb4c0150a
2 changed files with 7 additions and 6 deletions
+3 -2
View File
@@ -87,7 +87,8 @@ docker compose logs -f app
## Deployment (owner's homelab) ## Deployment (owner's homelab)
- Server `srv-stackpilot` (10.10.1.7, Debian 12, Docker 29), user `claude` (docker group, SSH key only), - Server `srv-stackpilot` (10.10.1.7, Debian 12, Docker 29), user `claude` (docker group, SSH key only),
checkout in `~/kochbuch`, `.env` there (mode 600, never commit). Port 8000 on the host. stack in `/opt/stacks/kochbuch` (managed by the owner's Docker manager; dir owned by claude),
`.env` there (mode 600, never commit). Port 8000 on the host.
- Reverse proxy is NPMplus on the same host → proxy host `kochbuch.dammann.vip` → `10.10.1.7:8000`. - Reverse proxy is NPMplus on the same host → proxy host `kochbuch.dammann.vip` → `10.10.1.7:8000`.
- Update: `cd ~/kochbuch && ./scripts/backup.sh && git pull && docker compose up -d --build`. - Update: `cd /opt/stacks/kochbuch && ./scripts/backup.sh && git pull && docker compose up -d --build`.
- Gitea: https://git.dammann.vip/dammann/Kochbuch (SSH alias `gitea`, port 2222). - Gitea: https://git.dammann.vip/dammann/Kochbuch (SSH alias `gitea`, port 2222).
+4 -4
View File
@@ -39,8 +39,8 @@ Technik: Django 5.2 (Python 3.12), PostgreSQL 17, gunicorn. Zwei Container, ca.
Voraussetzungen: Docker mit dem Compose-Plugin (`docker compose version`), Git. Voraussetzungen: Docker mit dem Compose-Plugin (`docker compose version`), Git.
```bash ```bash
git clone <gitea-url>/kochbuch.git /opt/kochbuch git clone <gitea-url>/kochbuch.git /opt/stacks/kochbuch
cd /opt/kochbuch cd /opt/stacks/kochbuch
./scripts/init-env.sh [email protected] # erzeugt .env mit zufälligen Secrets + Admin-Passwort ./scripts/init-env.sh [email protected] # erzeugt .env mit zufälligen Secrets + Admin-Passwort
nano .env # APP_BASE_URL, APP_PORT, TRUSTED_PROXIES, OPENAI_API_KEY prüfen nano .env # APP_BASE_URL, APP_PORT, TRUSTED_PROXIES, OPENAI_API_KEY prüfen
docker compose up -d --build docker compose up -d --build
@@ -166,7 +166,7 @@ Am Android-Handy geht's am schnellsten über **Teilen → Kochbuch** (App vorher
## Update ## Update
```bash ```bash
cd /opt/kochbuch cd /opt/stacks/kochbuch
./scripts/backup.sh # vorher sichern ./scripts/backup.sh # vorher sichern
git pull git pull
docker compose up -d --build # Migrationen laufen beim Start automatisch docker compose up -d --build # Migrationen laufen beim Start automatisch
@@ -189,7 +189,7 @@ KEEP=30 ./scripts/backup.sh # 30 Archive behalten
Täglich per Cron (`crontab -e`): Täglich per Cron (`crontab -e`):
```cron ```cron
30 3 * * * cd /opt/kochbuch && ./scripts/backup.sh /mnt/nas/kochbuch >> /var/log/kochbuch-backup.log 2>&1 30 3 * * * cd /opt/stacks/kochbuch && ./scripts/backup.sh /mnt/nas/kochbuch >> /var/log/kochbuch-backup.log 2>&1
``` ```
Das Archiv enthält die `.env` mit Passwörtern – entsprechend geschützt ablegen. Das Archiv enthält die `.env` mit Passwörtern – entsprechend geschützt ablegen.