vendoo/docs/INSTALLATION_1_34_0_ZERO_EDIT.md

Vendoo 1.34.0 – Zero-Edit-Installation

Grundsatz

Für keine unterstützte Betriebsart muss eine .env, Compose-Datei oder Proxy-Konfiguration manuell bearbeitet werden. Der Installer sammelt nur notwendige Angaben, validiert sie und schreibt die Konfiguration automatisch.

AI-, SMTP- und Marktplatz-Zugangsdaten werden nach dem ersten Login unter Vendoo → Einstellungen gepflegt. Im Docker-/NAS-/VPS-Betrieb werden diese Werte in einem persistenten Konfigurationsvolume gespeichert und nach Neustarts wieder geladen.

Windows lokal

1. setup.bat doppelklicken.
2. Lokal auf diesem Windows-PC wählen.
3. Erreichbarkeit festlegen:
   • nur dieser PC,
   • privates LAN.
4. Port bestätigen oder ändern.
5. optional eine LAN-Basisadresse für QR-Uploads eingeben.
6. optional FLUX aktivieren.
7. Installieren anklicken.
8. Erst-Admin-Code aus der Zwischenablage bei der ersten Einrichtung einfügen.

Node.js wird geprüft. Fehlt Node.js, bietet der bestehende Installer eine automatische Installation an.

Windows mit Docker Desktop

1. Docker Desktop starten.
2. setup.bat doppelklicken.
3. Docker Desktop auf diesem Windows-PC wählen.
4. Zugriff nur lokal oder im privaten LAN festlegen.
5. Port und optional QR-Basisadresse festlegen.
6. Installieren anklicken.

Der Assistent erzeugt .env, Setup-Code und Installationsmodus automatisch. Die App bleibt standardmäßig nur auf 127.0.0.1 erreichbar.

Linux oder macOS mit Docker

chmod +x setup.sh
./setup.sh

Im Menü Docker auf Linux/macOS/Docker Desktop wählen. Der Assistent fragt Port und FLUX-Konfiguration ab und startet anschließend Compose.

NAS / Portainer

1. Vendoo-Ordner auf das NAS kopieren.
2. im Ordner chmod +x setup.sh && ./setup.sh ausführen.
3. NAS / Portainer / privates LAN wählen.
4. Port und LAN-Basisadresse eingeben.
5. Installation starten.

Der Assistent legt automatisch folgende sichtbare Runtime-Verzeichnisse an:

• runtime/db
• runtime/uploads
• runtime/backups
• runtime/operations
• runtime/logs
• runtime/config

Diese Verzeichnisse werden bei Updates nicht gelöscht.

VPS mit automatischem HTTPS

Voraussetzungen:

• Domain zeigt per DNS auf den VPS,
• Ports 80 und 443 sind erreichbar,
• Docker Engine und Compose-Plugin sind installiert.

Ablauf:

chmod +x setup.sh
./setup.sh

Dann VPS / öffentlicher Server mit automatischem HTTPS wählen und den Domainnamen ohne Protokoll eingeben. Der integrierte Caddy-Stack beantragt und erneuert TLS-Zertifikate automatisch. Vendoo selbst veröffentlicht Port 8124 nicht direkt ins Internet.

Persistenter Konfigurationsspeicher

Im lokalen Windows-Betrieb verwendet Vendoo weiterhin die lokale .env. In Docker setzt der Installer automatisch:

VENDOO_CONFIG_PATH=/app/data/config/vendoo.env

Die Eingabemasken schreiben dort ihre Werte mit restriktiven Dateirechten. Das Haupt-Dateisystem des Containers bleibt schreibgeschützt.

Backup und sensible Konfiguration

Normale Docker-Backups enthalten Datenbank, Uploads, Backups, Operations und Logs. Der persistente Runtime-Konfigurationsspeicher mit API-/SMTP-/Marktplatzschlüsseln wird bewusst nicht in das normale Datenarchiv aufgenommen, damit ein weitergegebenes Backup nicht automatisch alle Zugangsdaten enthält.

Bei einer Wiederherstellung auf einem neuen System werden Betriebswerte durch den Installationsassistenten neu erzeugt und externe Zugangsdaten anschließend über Vendoo → Einstellungen erneut eingetragen. Dazu muss keine Datei manuell bearbeitet werden.

Updates

Im Linux-/NAS-/VPS-Assistenten erstellt Aktualisieren zuerst automatisch ein Sicherheitsbackup. Danach werden Image beziehungsweise Quellcontainer neu gebaut, gestartet und über /readyz geprüft.

Unter Windows bleibt der bestehende Update- und Rollback-Ablauf erhalten.

Nicht automatisch verändert

• Datenbank
• Uploads und Originalbilder
• Benutzer
• Artikel
• Backups
• Operations-Daten
• FLUX-Modelle
• ComfyUI-Daten
• API-Schlüssel