# Vendoo 1.33.0 – Installation und Abnahme

## 1. Bestehende Windows-Installation aktualisieren

1. Vendoo und FLUX schließen.
2. Release entpacken.
3. Den Inhalt von `vendoo` über den vorhandenen Projektordner kopieren.
4. Vorhandene Dateien ersetzen, den Zielordner nicht vorher leeren.
5. `.env`, Datenbank, Uploads, Backups, Operations, lokale Modelle und ComfyUI-Daten nicht löschen.
6. `setup.bat` starten.
7. **3 – Update** ausführen.
8. **2 – Starten** ausführen.

## 2. Neue Windows-Installation

`setup.bat` starten und unter **1 – Installieren / Installationsziel wählen** auswählen:

- **Windows lokal:** Node.js, npm und lokale Projektordner
- **Docker Desktop:** Compose-Build, getrennte Volumes und automatischer Setup-Code
- **NAS/Portainer:** Übergabe an den Linux-/NAS-Assistenten
- **VPS/Linux:** Installation direkt auf dem Zielserver

Der gewählte aktive Modus wird in `.vendoo-install-mode` gespeichert. Diese Datei enthält keine Geheimnisse.

## 3. Linux, NAS oder VPS

```bash
chmod +x setup.sh
./setup.sh
```

Auswahl:

1. Docker auf diesem Linux-/Docker-Host mit Named Volumes
2. NAS/Portainer mit sichtbaren `runtime`-Bind-Mounts
3. VPS hinter HTTPS-Reverse-Proxy

Der Assistent prüft Docker und das Compose-Plugin, erzeugt bei Bedarf `.env` sowie einen starken `VENDOO_SETUP_TOKEN`, validiert Compose und startet Vendoo.

### NAS

Der NAS-Modus legt folgende Ordner an:

```text
runtime/db
runtime/uploads
runtime/backups
runtime/operations
runtime/logs
```

Port 8124 wird im LAN veröffentlicht. Keine direkte Internet-Portfreigabe verwenden.

### VPS

- echte öffentliche `https://`-URL angeben
- DNS und TLS vorab oder anschließend korrekt konfigurieren
- Reverse Proxy auf `127.0.0.1:8124` weiterleiten
- Port 8124 nicht öffentlich freigeben
- `VENDOO_TRUST_PROXY=true` nur hinter dem eigenen Proxy verwenden

## 4. FLUX im Docker-Betrieb

FLUX bleibt ein getrennter Dienst. Im Docker-Container wird ein Host-Dienst über folgende URL erreicht:

```env
LOCAL_IMAGE_URL=http://host.docker.internal:8188
```

`LOCAL_IMAGE_ENABLED` nur aktivieren, wenn FLUX/ComfyUI tatsächlich separat läuft und abgesichert ist.

## 5. Abnahme

### Deployment

- `/healthz` liefert HTTP 200
- `/readyz` liefert HTTP 200 und `ok: true`
- Neustart erhält Benutzer, Artikel und Bilder
- Backup wird erzeugt und hat SHA-256
- Docker-Status zeigt `healthy`

### FLUX Studio

- Seite öffnen: Vorschau **Auswahl & Varianten** bleibt leer
- Historie ist sichtbar, aber kein Bild ist automatisch markiert
- Historienbild anklicken: Vorschau erscheint
- **Arbeitsbereich zurücksetzen**: Auswahl und Formular werden geleert/zurückgesetzt
- Bilder, Verlauf und Job-Center bleiben erhalten

### Benutzerverwaltung

- Benutzerliste laden
- Bearbeiten-Button öffnet das richtige Benutzerkonto
- Name, Rolle und Status speichern
- ungültiges Passwort verhindert die gesamte Speicherung
- gültiges Passwort wird gesetzt
- letzter aktiver Administrator kann nicht deaktiviert oder herabgestuft werden

## 6. Rollback

1. Vorheriges Vendoo-Paket über den Code kopieren.
2. `.env`, DB, Uploads und Volumes nicht ersetzen oder löschen.
3. Windows: `setup.bat` → Update → Starten.
4. Docker: `./setup.sh` → Aktualisieren oder vorheriges Image/Code bauen.
5. Readiness und Datenbestand prüfen.
