In Betrieb nehmen

services:
  nexview:
    image: ghcr.io/derkezorm/nexview:latest
    container_name: nexview
    restart: unless-stopped
    ports:
      - "5173:8000"
    volumes:
      - ./data:/data
    environment:
      PUID: 1000
      PGID: 1000
      TZ: Europe/Berlin

Ohne TMDB-Schlüssel startet Nexview mit Beispieldaten, du kannst es also erst ansehen und dann entscheiden. Datenbank, Schlüssel und Profilbilder liegen im Ordner ./data neben der Compose-Datei. Wer mit network_mode: host arbeitet, hat keine Portzuordnung, dann legt NEXVIEW_PORT fest, worauf Nexview lauscht; sonst bleibt es bei 8000.

Hinter einem Reverse Proxy: Nexview bremst die Anmeldung nach mehreren Fehlversuchen und sperrt sie danach für eine Viertelstunde, sie geht von selbst wieder auf. Gezählt wird immer nach Konto, dafür ist nichts einzustellen. Wer zusätzlich nach Adresse zählen will, setzt NEXVIEW_CLIENT_IP auf proxy (oder proxy:2 bei zweien, etwa Cloudflare und dahinter ein eigener) und sorgt dafür, dass der Proxy X-Forwarded-For weiterreicht, Nginx Proxy Manager, Caddy und Traefik tun das von selbst. Ohne Proxy heißt der Wert direct. Im Zweifel leer lassen: Steht dort direct, obwohl ein Proxy davorsteht, sehen alle Anfragen aus wie dieselbe Adresse, dann sperrt ein einziger Vertipper den ganzen Haushalt aus.

Im Unterpfad hinter dem Reverse Proxy: Nexview kann unter deinedomain.de/nexview laufen statt auf einer eigenen Subdomain. Eine Zeile in der Compose-Datei genügt, NEXVIEW_URL_BASE=/nexview, dann den Container neu starten. Beide üblichen Proxy-Einstellungen funktionieren, durchreichen wie abschneiden; fertige Beispiele für nginx, Caddy, Traefik und Nginx Proxy Manager stehen in der README. Wichtig: Die öffentliche Adresse in den Einstellungen muss den Unterpfad enthalten, Nexview schlägt sie richtig vor und warnt, wenn er fehlt; ohne ihn führen verschickte Links ins Leere.

NEXVIEW_URL_BASE: /nexview

location /nexview {
    proxy_pass http://127.0.0.1:5173;
    proxy_set_header Host $host;
}

handle /nexview* {
    reverse_proxy 127.0.0.1:5173
}

- traefik.http.routers.nexview.rule=PathPrefix(`/nexview`)
- traefik.http.services.nexview.loadbalancer.server.port=8000