# Beispiel, kein fertiger Betrieb. Jeder Pfad hier gehört angepasst.
#
# Übernommen aus einem laufenden Plex-Container auf einem UGREEN-NAS — die
# Form ist bewährt, die Werte sind es nur dort.

services:
  flaro:
    image: ghcr.io/scarriffle/flaro:latest
    container_name: flaro
    restart: unless-stopped

    ports:
      - "8080:8080"

    environment:
      - TZ=Europe/Zurich

      # Plakate, Hintergründe und NFO-Dateien neben den Film legen.
      #
      # **Standardmässig aus.** Dafür muss die Medieneinhängung unten ohne
      # `:ro` stehen — und damit kann der Server dort im Grundsatz schreiben.
      # Dass er nur Beiwerk anlegt, hängt an einer Erlaubnisliste im Code
      # (`SidecarNames`): poster.jpg, fanart.jpg, logo.png, movie.nfo,
      # tvshow.nfo, je Folge eine NFO und ein Standbild. Alles andere lehnt er
      # ab, auch Mediendateien — die werden nie geändert, umbenannt oder
      # gelöscht.
      #
      # Der Gewinn: dein Bestand wird tragbar. Ein Umzug, ein Neuaufbau der
      # Datenbank oder ein zweiter Server finden Zuordnungen und Bilder wieder.
      - FLARO_WRITE_SIDECARS=true

    # Wem die Dateien auf dem Wirt gehören. 1000:1000 ist die Voreinstellung
    # im Image; wer andere Kennungen hat, trägt sie hier ein — `id -u` und
    # `id -g` auf dem Wirt sagen, welche.
    user: "1000:1000"

    volumes:
      # Datenbank und Einstellungen. **Das Einzige, was gesichert werden muss.**
      - /volume4/CRITICAL/Docker/Flaro/config:/config

      # Bilder und Zwischenstände. Darf verlorengehen, baut sich neu auf.
      - /volume4/CRITICAL/Docker/Flaro/cache:/cache

      # Kratzplatz fürs Umrechnen. Am besten auf eine SSD und nicht dorthin,
      # wo die Medien liegen — hier wird viel und kurzlebig geschrieben.
      - /volume1/Transcode:/transcode

      # Die Medien.
      #
      # **Ohne `:ro`, weil FLARO_WRITE_SIDECARS oben an ist.** Wer das nicht
      # will, setzt die Variable auf `false` und hängt wieder mit `:ro` ein —
      # dann bleiben Bilder und Metadaten nur in Flaros Cache, und der Bestand
      # ist gegen jeden Zugriff des Servers geschützt.
      #
      # Transcode-Zwischenstände kommen hier **nie** her; die liegen auf dem
      # eigenen Volume darüber.
      #
      # Was hier eingehängt wird, ist der Pfad, den du später in der Oberfläche
      # als Bibliothek anlegst — also `/media`, nicht `/volume4/MYFLIX`.
      - /volume4/MYFLIX:/media

    # Hardware fürs Umrechnen. Intel wie AMD laufen über VAAPI an derselben
    # Stelle. Fehlt die Zeile, rechnet Flaro in Software — langsamer, aber es
    # läuft. Zum blossen Umpacken wird sie ohnehin nicht gebraucht.
    devices:
      - /dev/dri:/dev/dri

    healthcheck:
      test: ["CMD", "dotnet", "--info"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 20s