diff --git a/docs/install/README.md b/docs/install/README.md index 915ff46..a5276d7 100644 --- a/docs/install/README.md +++ b/docs/install/README.md @@ -347,4 +347,82 @@ chown -R 1000:1000 /volume1/docker/spawner/logs --- +## Synology NAS / BusyBox Kompatibilitaet + +Das Installationsskript ist vollstaendig kompatibel mit Synology NAS und anderen BusyBox-basierten Systemen. + +### Automatische Anpassungen + +Das Skript erkennt und behandelt automatisch: + +| Problem | Loesung | +|---------|---------| +| `git safe.directory` Fehler | Automatische Konfiguration | +| Kein `sort -V` (Versionsort) | Eigene Versionsvergleich-Funktion | +| Kein `grep -P` (Perl-Regex) | POSIX-kompatible Alternativen | +| Kein `--progress=plain` | Flag wird nicht verwendet | +| Aeltere Docker-Version | BuildKit-Features deaktiviert | + +### Bekannte Einschraenkungen auf Synology + +1. **Build-Zeit**: Docker-Builds dauern laenger (5-15 Min fuer Next.js) +2. **RAM**: Mindestens 4 GB RAM empfohlen +3. **Docker-Version**: Synology verwendet oft aeltere Docker-Versionen + +### Manuelle Vorbereitung (optional) + +```bash +# Als root auf der Synology einloggen +sudo -i + +# In Installationsverzeichnis wechseln +cd /volume1/docker +mkdir spawner +cd spawner + +# Installation starten +curl -sSL https://gitea.iotxs.de/RainerWieland/spawner/raw/branch/main/install.sh | bash +``` + +### Troubleshooting Synology + +#### "dubious ownership" Fehler + +Falls dieser Fehler auftritt: + +```bash +git config --global --add safe.directory /volume1/docker/spawner +``` + +Das Skript macht dies automatisch, aber bei Problemen kann es manuell ausgefuehrt werden. + +#### Docker-Build schlaegt fehl + +```bash +# Build-Logs pruefen +cat /tmp/build-user-template.log +cat /tmp/build-spawner.log +cat /tmp/build-frontend.log + +# Images manuell bauen +cd /volume1/docker/spawner +docker build -t user-service-template:latest ./user-template/ +docker build -t spawner:latest . +docker build -t spawner-frontend:latest ./frontend/ +``` + +#### Container startet nicht + +```bash +# Logs pruefen +docker logs spawner +docker logs spawner-frontend + +# Netzwerk pruefen +docker network ls +docker network inspect web +``` + +--- + Zurueck zur [Dokumentations-Uebersicht](../README.md) diff --git a/docs/versions/CHANGELOG.md b/docs/versions/CHANGELOG.md index ca115ae..a646d46 100644 --- a/docs/versions/CHANGELOG.md +++ b/docs/versions/CHANGELOG.md @@ -19,6 +19,39 @@ Das Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.0.0/). --- +## [0.2.0] - 2026-01-31 + +### Hinzugefuegt +- Synology NAS / BusyBox Kompatibilitaet im Installationsskript +- Automatische Docker-Version Pruefung (>= 20.10) +- Automatische Docker Compose Version Pruefung (>= 2.0) +- Traefik-Laufzeit-Pruefung im Installationsskript +- Traefik-Netzwerk-Verbindungspruefung +- Build-Fortschrittsanzeige mit gefilterten Logs +- Automatische `git safe.directory` Konfiguration fuer NAS-Umgebungen + +### Geaendert +- `auth.py`: Redirect zum Frontend statt Jinja2-Templates +- `docker-compose.yml`: Legacy-Router entfernt (verhindert Redirect-Loop) +- Dockerfiles: Fallback auf `npm install` wenn `package-lock.json` fehlt +- `--progress=plain` Flag entfernt (nicht kompatibel mit aelteren Docker-Versionen) +- Build-Verifikation prueft jetzt Exit-Code UND Image-Existenz + +### Behoben +- Redirect-Loop bei `/login` und `/signup` behoben +- `@/lib/utils` Module-Not-Found Fehler in Next.js Projekten +- `.gitignore` blockierte `frontend/src/lib/` und `user-template-next/src/lib/` +- `tsconfig.json` fehlte `baseUrl` fuer TypeScript Path Aliases +- Docker Build meldete faelschlicherweise "OK" bei Fehlern + +### Entfernt +- `templates/` Verzeichnis (alte Jinja2 Templates, ersetzt durch Next.js Frontend) + +### Sicherheit +- Keine sensiblen Dateien (`.env`, `CLAUDE.md`) werden ins Repository kopiert + +--- + ## [0.1.0] - 2026-01-30 ### Hinzugefuegt