Fehlerbehebung

Finde dein Symptom, lies die Ursache, folge der Lösung. Die Beispiele verwenden den Container-Namen holyarrs; nimm deinen, wenn er anders heißt.

Die ersten 3 Prüfungen

1. Sieh dir das Log an: docker logs -f holyarrs. Geheime Werte sind maskiert. Mit Strg+C beendest du das Mitlesen; der Container läuft weiter.
2. Führe den Doctor aus: docker exec holyarrs /holyarrs doctor. Jede Zeile meldet OK, WARN oder FAIL, und bei jedem WARN oder FAIL steht, wie du es behebst.
3. Du kommst immer noch nicht weiter? Lade ein Support-Paket herunter und frag nach. Siehe Support erhalten.

Die Webseite ist nicht erreichbar

Symptom: Der Browser kann sich nicht mit http://your-server:6262 verbinden.

Ursache: Der Container ist gestoppt, der Port ist nicht zugeordnet oder ein Proxy steht im Weg.

Lösung:

1. Führe docker ps aus. Du solltest holyarrs mit 0.0.0.0:6262->6262 sehen.
2. Wenn er ständig neu startet, lies den Grund in docker logs holyarrs nach.
3. Wenn du einen Pfad wie /holyarrs nutzt, siehe Reverse Proxy und URL base.

Zugriff verweigert

Symptom: Der Doctor meldet, dass ein Ordner nicht beschreibbar ist, oder Importe scheitern mit einem Berechtigungsfehler.

Ursache: Der Eigentümer des Ordners auf dem Host passt nicht zu PUID und PGID.

Lösung: Führe den chown-Befehl aus, den der Doctor vorschlägt, oder setze PUID und PGID auf den Eigentümer des Ordners. Auf einem NAS gibst du diesem Benutzer in der Berechtigungsübersicht Lese- und Schreibzugriff. Siehe NAS, Synology und Unraid.

Nichts wird heruntergeladen

Symptom: Titel bleiben fehlend und nichts kommt bei deinem Downloader an.

Ursache: Keine Quelle antwortet, der Downloader ist nicht verbunden oder kein Release besteht deine Auswahlregeln.

Lösung:

1. Öffne Settings > Downloaders (Einstellungen > Downloader) und klicke bei deinem Downloader auf Test (Testen). Der Test sollte bestehen.
2. Öffne Settings > Sources (Einstellungen > Quellen) und klicke bei jeder Quelle auf Test.
3. Öffne beim Titel Choose a release (Release auswählen). Dort siehst du jedes Ergebnis und die Gründe, warum es nicht gewählt wurde.

Siehe Downloader und Quellen.

Heruntergeladen, aber nicht importiert

Symptom: Der Download ist in deinem Downloader fertig, aber der Titel ist nicht in deiner Bibliothek.

Ursache: HolyArrs sieht die Datei nicht unter demselben Pfad, kann nicht in den Bibliotheksordner schreiben oder der Import braucht eine Entscheidung.

Lösung:

1. Gib HolyArrs und dem Downloader denselben Download-Ordner unter demselben Pfad, etwa /downloads, oder setze beim Downloader Downloader’s path (Pfad des Downloaders) und HolyArrs’ path (Pfad von HolyArrs).
2. Führe den Doctor aus und behebe jedes FAIL bei den Download- oder Bibliotheksordnern.
3. Prüfe die Download-Liste auf Einträge mit Needs a decision (Entscheidung nötig) und genehmige oder verwirf den Plan.

Importe sind Kopien, keine Hardlinks

Symptom: Der Doctor meldet, dass Hardlinks (harte Verknüpfungen) nicht funktionieren, oder der belegte Speicherplatz verdoppelt sich nach Importen.

Ursache: Downloads und Bibliotheksordner liegen auf verschiedenen Datenträgern oder Mounts.

Lösung: Binde einen gemeinsamen übergeordneten Ordner in den Container ein statt mehrerer einzelner. Siehe Ordner.

HolyArrs startet nicht

Symptom: Der Container stoppt oder startet sofort neu.

Ursache: Das Log nennt sie. Häufig: /config auf einer Netzwerkfreigabe oder einem FUSE-Pfad, oder ein defekter Bereich.

Lösung:

1. Verschiebe /config auf einen lokalen Datenträger, wenn das Log es sagt. HolyArrs betreibt seine Datenbank nicht auf einer Freigabe.
2. Sonst starte im abgesicherten Modus, behebe das Problem in Settings (Einstellungen) und starte normal neu.

Eine Funktion fehlt

Symptom: Eine Funktion, von der du gelesen hast, ist nicht in der App.

Ursache: Sie ist in dieser Version vielleicht zurückgestellt.

Lösung: Siehe Zurückgestellte Funktionen.

Seiten haben keine Namen oder Bilder

Symptom: Titel erscheinen ohne Poster oder Details.

Ursache: Der Metadaten-Server ist nicht erreichbar.

Lösung: Prüfe dein DNS und deine Firewall. Der Abschnitt Network (Netzwerk) im Doctor zeigt, ob der Server antwortet.

Für Fortgeschrittene

Prüfungen und Optionen des Doctors

Der Doctor läuft im Container als derselbe Benutzer wie HolyArrs. Er stößt also auf dasselbe wie HolyArrs.

Abschnitt	Zeigt
App	Version, Benutzer und Gruppe, umask, ob die App in einem Container läuft.
Konfigurationsordner	Eigentümer, Berechtigungen, freier Speicherplatz, ob er auf einem lokalen Datenträger liegt.
Bibliotheks- und Download-Ordner	Vorhanden, Eigentümer, beschreibbar, freier Speicherplatz, Hardlinks zwischen Download- und Bibliotheksordnern.
Netzwerk	Ob der Name des Metadaten-Servers aufgelöst wird und der Server antwortet.
Uhr	Uhrzeit, Zeitzone (TZ), eine Warnung, wenn die Uhr eindeutig falsch geht.

Option	Was sie tut
-config <folder>	Prüft einen anderen HolyArrs-Konfigurationsordner als /config.
-json	Gibt den Bericht als JSON aus.

Exit-Code 0 heißt, dass nichts fehlgeschlagen ist; 1 heißt, dass eine Zeile FAIL meldet. Der Bericht zeigt nie Schlüssel, Passwörter oder Tokens. Er liest nur, bis auf eine kleine Testdatei, die er schreibt und wieder entfernt. Als root gestartet übergibt er außerdem den Konfigurationsordner an PUID:PGID, wie ein normaler Start.

Wenn HolyArrs ständig neu startet, schlägt docker exec fehl. Führe den Doctor in einem neuen Container mit denselben Ordnern aus:

docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> -e TZ=<tz> holyarrs/holyarrs:<tag> doctor

Mit Compose: docker compose run --rm holyarrs doctor.

Ordnerprüfung beim Start

Beim Start prüft HolyArrs seine Ordner und schreibt eine Zusammenfassung ins Log, etwa folders: 4 ok, 1 not writable, danach eine Zeile pro Problemordner mit einer Lösung. Die Prüfung endet nach 3 Sekunden, damit der Start nie hängt. Ein Ordner, der zu langsam antwortet, gilt als nicht geprüft; oft ist das ein Datenträger, der aus dem Ruhezustand aufwacht, oder eine langsame Netzwerkfreigabe. Der Doctor prüft ihn ohne das Zeitlimit. Siehe Logs.

Keine Shell im Image

Das Image enthält nur das HolyArrs-Programm. So bleibt es klein und bietet einem Angreifer weniger. docker exec holyarrs sh schlägt mit Absicht fehl. Für einen genaueren Blick startest du daneben einen Wegwerf-Helfer:

docker run --rm -it --pid container:holyarrs --network container:holyarrs --volumes-from holyarrs busybox sh

Er sieht den HolyArrs-Prozess, teilt dessen Netzwerk und hat dieselben Ordner unter denselben Pfaden. Er läuft als root, also schau nur und ändere nichts: Eine als root geschriebene Datei kann für HolyArrs unlesbar sein. Um als HolyArrs-Benutzer zu testen, füge --user <PUID>:<PGID> hinzu.

Die Version herausfinden

docker inspect --format '{{ index .Config.Labels "org.opencontainers.image.version" }}' holyarrs

Der Abschnitt App im Doctor zeigt dasselbe.

Verwandte Seiten

• Support erhalten
• Logs
• Zustandsprüfungen