Lumio / self-hosted
Anleitung

Lumio auf QNAP & Unraid installieren.

Beide sind NAS-/Homeserver-Plattformen mit Docker — der Stack ist derselbe wie bei Synology. Diese Anleitung zeigt die plattformspezifischen Einstiege; für die geteilten Details verweisen wir auf den Synology-Guide.

Passt dein Gerät?

  • QNAP mit Container Station 3+ (bringt Docker Compose v2) oder Unraid 6.12+ mit Docker
  • 64-Bit — x86-64 empfohlen, arm64 möglich (ohne GPU-Tagging); 32-Bit nicht unterstützt
  • RAM: nur Fotos ab 4 GB, mit Video 8 GB, KI-Tagging +4 GB (auf einem NAS besser aus)
  • Freier Platz auf einem Volume/Pool für die Daten

QNAP — Container Station

  1. Container Station aus dem App Center installieren (Version 3+).
  2. Die Lumio-Dateien in einen freigegebenen Ordner legen, z.B. /share/Container/lumio — per SSH (git clone) oder per File Station hochladen.
  3. In Container Station eine Application aus der vorhandenen docker-compose.yml anlegen (oder per SSH docker compose … up -d).
  4. Caddy-Ports weglegen (QTS nutzt 80/443): CADDY_HTTP_PORT=8080, CADDY_HTTPS_PORT=8443.
  5. TLS über den QNAP-Reverse-Proxy oder einen Tunnel — External-RP-Modus wie im Synology-Guide.

Unraid — Docker

  1. Über Community Apps das Plugin Docker Compose Manager installieren (macht docker compose in der Unraid-UI nutzbar).
  2. Lumio-Dateien nach /mnt/user/appdata/lumio legen (git clone per Terminal oder Upload).
  3. Ein neues Compose-Stack im Plugin anlegen, das auf diese docker-compose.yml zeigt.
  4. Belegt die Unraid-WebUI 80/443, Caddy auf hohe Ports legen (CADDY_HTTP_PORT=8080/8443).
  5. TLS am einfachsten über deinen vorhandenen Reverse-Proxy (SWAG oder Nginx Proxy Manager) — External-RP-Modus, siehe Synology-Guide.

Gemeinsam — konfigurieren & starten

Auf beiden Plattformen gleich (per SSH/Terminal):

cp .env.example .env
# Secrets setzen
sed -i "s|^POSTGRES_PASSWORD=.*|POSTGRES_PASSWORD=$(openssl rand -base64 24 | tr -d '/+=')|" .env
sed -i "s|^JWT_SECRET=.*|JWT_SECRET=$(openssl rand -base64 32 | tr -d '/+=')|" .env
sed -i "s|^SESSION_SECRET=.*|SESSION_SECRET=$(openssl rand -base64 32 | tr -d '/+=')|" .env
sed -i "s|^S3_ACCESS_KEY=.*|S3_ACCESS_KEY=$(openssl rand -hex 12)|" .env
sed -i "s|^S3_SECRET_KEY=.*|S3_SECRET_KEY=$(openssl rand -base64 32 | tr -d '/+=')|" .env

# Für External-Reverse-Proxy (QNAP-RP / SWAG / NPM / Tunnel):
# LUMIO_HOST, LUMIO_S3_HOST, PUBLIC_URL, S3_PUBLIC_URL setzen
# und CADDY_HTTP_PORT=8080 (Details: Synology-Guide)

docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d
docker compose exec api npm run create-admin -- --email=du@deinstudio.de --password=mind12zeichen

Die geteilten TLS-/Reverse-Proxy-Details stehen ausführlich im Synology-Guide; Backups erklärt die Backup-Anleitung.

Häufige Fragen zu QNAP & Unraid

QNAP oder Unraid — was ist einfacher? +

Unraid, wenn du ohnehin schon einen Reverse-Proxy (SWAG oder Nginx Proxy Manager) laufen hast — dann fügt sich Lumio nahtlos ein. QNAP ist über die Container Station komfortabel für alle, die keine Kommandozeile mögen. Der eigentliche Stack ist auf beiden identisch; die Unterschiede liegen nur in der Oberfläche und beim Reverse-Proxy.

Läuft es auf ARM-basierten QNAP-Modellen? +

Auf 64-Bit-ARM (arm64) ja, mit denselben Einschränkungen wie auf jeder ARM-Maschine: kein GPU-Tagging, Transcoding auf CPU. Empfohlen sind aber die x86-64-Modelle mit ausreichend RAM — genau wie bei Synology. 32-Bit-Modelle werden nicht unterstützt.

Wie löse ich Port-Konflikte mit der NAS-Oberfläche? +

Sowohl QTS (QNAP) als auch die Unraid-WebUI belegen typischerweise 80/443. Leg Lumios Caddy in der .env auf hohe Ports (CADDY_HTTP_PORT=8080, CADDY_HTTPS_PORT=8443) und stell den Reverse-Proxy des Systems bzw. deinen SWAG/NPM davor. Das ist derselbe External-Reverse-Proxy-Modus wie im Synology-Guide.

Wie mache ich Backups auf QNAP/Unraid? +

Wie überall: die Postgres-Datenbank und die MinIO-Objektdaten sichern, plus die .env. Auf Unraid bietet sich das appdata-Backup-Plugin an, auf QNAP Hybrid Backup Sync. Die genauen Befehle stehen in der Backup-Anleitung.

Bereit für deine eigene Galerie?

Source-Code auf GitHub, Fragen und Diskussionen ebenfalls dort. Wenn in der Anleitung etwas hakt, melde dich — wir verbessern die Docs gerne.