Speicherung

VidArch trennt den Anwendungszustand von den umfangreichen Medien.

data/

Dieses Verzeichnis enthält die SQLite-Datenbank, optionale Cookies, den Sitzungsschlüssel und zwischengespeicherte Ressourcen. Es ist für eine konsistente Wiederherstellung unerlässlich.

downloads/

Dieses Verzeichnis enthält heruntergeladene Videos, Vorschaubilder und Metadaten. Die Größe hängt direkt von der Dauer und der Qualität der Videos ab.

Empfehlungen

• Verwenden Sie persistente Mounts;
• Überwachen Sie den freien Speicherplatz, bevor Sie automatische Downloads aktivieren;
• Sichern Sie data/ und downloads/ zum selben Zeitpunkt;
• Mounten Sie diese Verzeichnisse nicht von einem instabilen Freigabedienst;
• Vermeiden Sie jede Synchronisation, die die Datenbank während der Nutzung verändern könnte.

Berechtigungen für Bind-Mounts

Das veröffentlichte Image läuft mit der nicht privilegierten Identität 1000:1000. Ein Host-Verzeichnis, das unter /app/data oder /app/downloads eingehängt wird, muss daher für UID 1000 les- und schreibbar sein. Prüfe zuerst den aktuellen Zustand:

stat -c '%u:%g %A %n' ./data ./downloads

Erstelle die ausschließlich für VidArch bestimmten Standardverzeichnisse vor dem ersten Start und weise ihnen den erwarteten Besitzer zu:

mkdir -p ./data ./downloads
sudo chown -R 1000:1000 ./data ./downloads

Bei einer vorhandenen gemeinsam genutzten Medienbibliothek geben POSIX-ACLs VidArch Zugriff, ohne den aktuellen Besitzer zu ersetzen:

sudo setfacl -R -m u:1000:rwX /pfad/zur/medienbibliothek
sudo setfacl -m d:u:1000:rwx /pfad/zur/medienbibliothek

Verwende anschließend den absoluten Host-Pfad in Compose:

volumes:
  - ./data:/app/data
  - /pfad/zur/medienbibliothek:/app/downloads

Prüfe die wirksame Berechtigung nach dem Start:

docker compose exec vidarch sh -c 'id && test -w /app/data && test -w /app/downloads && echo writable'

Falls setfacl unter Debian oder Ubuntu fehlt, installiere das Paket acl. Vermeide chmod 777: Damit erhalten alle lokalen Konten und Container Schreibzugriff statt nur der benötigten Identität.

Die Seite Einstellungen → Speicherung & Dateien zeigt den genutzten Speicherplatz an und ermöglicht die Bereinigung des temporären Caches, ohne die Archive zu löschen.