NAS, Synology und Unraid

Neu hier

Betreibe HolyArrs auf deinem NAS mit den richtigen Ordnern, dem richtigen Eigentümer und der richtigen Neustart-Einstellung. Lies zuerst Installieren.

Bevor du beginnst

/config gehört auf ein lokales Volume oder einen lokalen Pool. Nie auf eine Netzwerkfreigabe.
Medien gehören in einen gemeinsamen Ordner, in dem downloads, movies, tv und music liegen. Binde jeden einzeln ein, oder für Hardlinks (harte Verknüpfungen) einmal den übergeordneten Ordner. Siehe Ordner.

Dein NAS einrichten

::tab[Synology]

Lege in File Station docker/holyarrs/config an.
Lege einen gemeinsamen Ordner media an, in dem downloads, movies, tv und music liegen.
Öffne im Container Manager Project > Create (Projekt > Erstellen) und füge die Compose-Datei aus Installieren ein.
Setze die Volumes auf /volume1/docker/holyarrs/config:/config, dann /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music und /volume1/media/downloads:/downloads.
Setze PUID und PGID auf deinen Benutzer, oft 1026 und 100. Prüfe das mit id <user> über SSH.
Gib diesem Benutzer Lese- und Schreibzugriff auf media: Control Panel > Shared Folder > Edit > Permissions (Systemsteuerung > Freigegebener Ordner > Bearbeiten > Berechtigungen).
Setze den Haken bei Enable auto-restart (Automatischen Neustart aktivieren).
Öffne http://your-server:6262. Du solltest den Assistenten für den ersten Start sehen. Füge /movies, /tv und /music als Bibliotheksordner hinzu.

::tab[Unraid]

Es gibt noch keine Vorlage in Community Applications, also füge den Container von Hand hinzu.

Füge im Docker-Tab einen Container mit dem HolyArrs-Image hinzu.
Ordne den Port 6262 zu.
Ordne /config einem Pool-Pfad zu, etwa /mnt/<pool>/appdata/holyarrs. <pool> ist der Name deines Pools. Nicht /mnt/user/appdata.
Ordne deine Medienordner /movies, /tv, /music und /downloads zu und nimm dafür Datenträger- oder Pool-Pfade, zum Beispiel /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music und /mnt/<pool>/media/downloads:/downloads.
Setze PUID=99, PGID=100 (bei Unraid nobody:users) und UMASK=022.
Schalte den Autostart für den Container ein, damit er von selbst neu startet.
Öffne http://your-server:6262. Du solltest den Assistenten für den ersten Start sehen.

::tab[QNAP]

Lege Container/holyarrs/config und eine Freigabe media an, in der downloads, movies, tv und music liegen.
Öffne in Container Station Applications > Create (Anwendungen > Erstellen) und füge die Compose-Datei ein.
Nimm /share/Container/holyarrs/config:/config, dann /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music und /share/media/downloads:/downloads.
Setze PUID und PGID auf den Eigentümer der Freigabe media.
Setze die Neustart-Richtlinie auf unless-stopped.
Öffne http://your-server:6262. Du solltest den Assistenten für den ersten Start sehen.

::tab[TrueNAS SCALE]

Lege 2 Datasets an: apps/holyarrs-config und media, mit den Ordnern downloads, movies, tv und music in media.
Füge unter Apps eine eigene App aus YAML mit der Compose-Datei hinzu.
Nimm /mnt/<pool>/apps/holyarrs-config:/config, dann /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music und /mnt/<pool>/media/downloads:/downloads.
Setze PUID und PGID auf den Eigentümer des Datasets, oft 568. Gib diesem Benutzer Schreibzugriff in der ACL des Datasets.
Setze die Neustart-Richtlinie auf unless-stopped.
Öffne http://your-server:6262. Du solltest den Assistenten für den ersten Start sehen.

Für jedes NAS gilt: Gib dem PUID-Benutzer in den Berechtigungen des NAS Lese- und Schreibzugriff auf den Medienordner; um den Konfigurationsordner kümmert sich HolyArrs selbst. Schalte den automatischen Neustart für den Container ein (bei Docker die Richtlinie unless-stopped).

Hardlinks brauchen keinen zusätzlichen Platz und sind sofort fertig. Binde dafür den einen Medienordner anstelle der vier ein, und gib deinem Downloader denselben Mount unter demselben Pfad. Siehe Medienordner.

Optionen

Getrennte Mounts

/movies, /tv, /music und /downloads einzeln einzubinden funktioniert, aber jeder Import wird dann zu einer vollständigen Kopie. Jeder Mount ist im Container ein eigenes Dateisystem, und ein Hardlink kann nicht über Dateisysteme hinweg zeigen. Getrennte Freigaben oder Datasets unter einem übergeordneten Ordner werden auch kopiert. Settings > Library folders (Einstellungen > Bibliotheksordner) warnt, wenn HolyArrs kopieren muss.

Deine Datenträger schlafen lassen

Diese Aufgaben wecken die Datenträger mit den Medien. Wie oft sie laufen, änderst du auf der Seite Schedules (Zeitpläne).

Aufgabe	Was sie liest
Rescan the Library (Bibliothek neu einlesen)	Jeden Bibliotheksordner. Weckt die Datenträger am häufigsten.
Check Library folders (Bibliotheksordner prüfen)	Die Angaben und den freien Speicherplatz jedes Ordners. Der Schreib- und Hardlink-Test läuft nur beim Start, bei Run now (Jetzt ausführen) und wenn sich Ordner ändern.
Look for missing subtitles (Fehlende Untertitel suchen), Look for better subtitles (Bessere Untertitel suchen)	Den Ordner neben jedem Video.

Lege /config und den Download-Ordner auf eine SSD oder einen Cache-Pool.
Halte 1 GB auf dem Datenträger frei, auf dem /config liegt. Darunter bekommst du eine Zustandswarnung.
Auf Unraid hält das Plugin Cache Directories die Ordnerlisten im Arbeitsspeicher, so kommen Scans ohne den Datenträger aus.
Importieren, Hinzufügen und Löschen greifen auf den Datenträger zu, auf dem sie arbeiten, und zwar dann, wenn sie passieren.
Stelle das erneute Einlesen auf alle 7 Tage oder auf aus. Dateien, die du von Hand hinzufügst, werden dann nur gefunden, wenn du bei Rescan the Library auf Run now klickst.
Ein Torrent, der seedet, liest seine Datei. Wenn sie per Hardlink in deiner Bibliothek liegt, bleibt dieser Datenträger wach, bis das Seeden endet.

Wenn es nicht funktioniert

Symptom	Ursache	Lösung
Startet nicht und nennt einen FUSE-Pfad, eine Netzwerkfreigabe oder eine User-Freigabe von Unraid	`/config` liegt nicht auf einem lokalen Datenträger (auf Unraid zeigt es auf `/mnt/user`)	Verschiebe `/config` auf einen lokalen Datenträger oder Pool-Pfad, etwa `/mnt/<pool>/appdata/holyarrs`.
Bleibt nach einem Neustart oder einer Wiederherstellung gestoppt	Der automatische Neustart ist aus	Schalte ihn ein und starte den Container.
Importe schlagen mit einem Berechtigungsfehler fehl	Der `PUID`-Benutzer kann nicht in die Medien schreiben	Gib ihm in den Berechtigungen des NAS Lese- und Schreibzugriff (auf Synology: Control Panel > Shared Folder > Edit > Permissions).
Importe sind Kopien, keine Hardlinks	Downloads und Bibliothek liegen auf verschiedenen Mounts oder Datenträgern	Binde einen gemeinsamen Ordner einmal ein, in HolyArrs und im Downloader.

Mehr Lösungen: Fehlerbehebung.

Für Fortgeschrittene

Warum HolyArrs manche Konfigurationspfade ablehnt

HolyArrs legt seine Datenbanken in /config ab. Netzwerkfreigaben und FUSE-Pfade können sie beschädigen. Deshalb startet HolyArrs auf so einem Pfad nicht und sagt, warum.

Auf Unraid ist /mnt/user ein FUSE-Pfad. Nimm einen Pool-Pfad oder mache appdata exklusiv: Schalte Permit exclusive shares (Exklusive Freigaben erlauben) unter Settings > Global Share Settings (Einstellungen > Globale Freigabe-Einstellungen) ein und setze dann Shares > appdata (Freigaben > appdata) auf primären Speicher auf einem Pool und sekundären Speicher auf keinen.

Ein /config-Pfad auf einem Pool, den es nicht gibt, landet im Arbeitsspeicher und geht beim Neustart verloren. Auch das lehnt HolyArrs ab. Meide /mnt/user auch für Medien; Hardlinks darüber können fehlschlagen.

Warum der automatische Neustart wichtig ist

Der Neustart in der App, der abgesicherte Modus und die Wiederherstellung eines Backups stoppen alle HolyArrs und erwarten, dass Docker es wieder startet. Ohne automatischen Neustart bleibt es gestoppt. Siehe Bereiche und abgesicherter Modus.

Port und Updates

Ordne den Port 6262 nur deinem Heimnetz zu. Lies Grundlagen der Sicherheit, bevor du ihn für jemanden von außen öffnest.
Zum Aktualisieren ziehst du das neue Image und erstellst den Container neu. Deine Daten bleiben in /config. Siehe Updates.