Felsökning

Hitta ditt symptom, läs orsaken och följ lösningen. Exemplen använder containernamnet holyarrs; använd ditt eget om det skiljer sig.

De tre första kontrollerna

1. Titta i loggen: docker logs -f holyarrs. Hemligheter är maskerade. Tryck Ctrl+C för att sluta följa loggen; containern fortsätter köra.
2. Kör doktorn: docker exec holyarrs /holyarrs doctor. Varje rad säger OK, WARN eller FAIL, och varje WARN eller FAIL berättar hur du löser det.
3. Fortfarande kört fast? Ladda ner ett supportpaket och be om hjälp. Se Få support.

Webbsidan går inte att nå

Symptom: webbläsaren kan inte ansluta till http://your-server:6262.

Orsak: containern är stoppad, porten är inte mappad eller en proxy står i vägen.

Lösning:

1. Kör docker ps. Du ska se holyarrs med 0.0.0.0:6262->6262.
2. Om den startar om hela tiden, läs docker logs holyarrs för att se varför.
3. Om du använder en sökväg som /holyarrs, se Reverse proxy och URL base.

Åtkomst nekad

Symptom: doktorn säger att en mapp inte är skrivbar, eller importer misslyckas med ett behörighetsfel.

Orsak: mappens ägare på hosten matchar inte PUID och PGID.

Lösning: kör den chown som doktorn föreslår, eller sätt PUID och PGID till mappens ägare. På en NAS ger du den användaren läs- och skrivrättigheter på behörighetsskärmen. Se NAS, Synology och Unraid.

Inget laddas ner

Symptom: titlar förblir saknade och ingenting når din nedladdare.

Orsak: ingen källa svarar, nedladdaren är inte ansluten eller ingen release klarar dina urvalsregler.

Lösning:

1. Öppna Settings > Downloaders (Inställningar > Nedladdare) och klicka på Test (testa) på din nedladdare. Den ska bli godkänd.
2. Öppna Settings > Sources (Inställningar > Källor) och klicka på Test på varje källa.
3. Öppna Choose a release (välj release) på titeln för att se alla resultat och skälen till att de inte valdes.

Se Nedladdare och Källor.

Nedladdad men inte importerad

Symptom: nedladdningen blev klar i din nedladdare, men titeln finns inte i ditt bibliotek.

Orsak: HolyArrs ser inte filen på samma sökväg, kan inte skriva till biblioteksmappen, eller importen kräver ett beslut.

Lösning:

1. Ge HolyArrs och nedladdaren samma nedladdningsmapp på samma sökväg, till exempel /downloads, eller ange Downloader’s path (nedladdarens sökväg) och HolyArrs’ path (HolyArrs sökväg) på nedladdaren.
2. Kör doktorn och åtgärda alla FAIL för nedladdnings- eller biblioteksmapparna.
3. Titta i nedladdningslistan efter poster markerade Needs a decision (kräver beslut), och godkänn eller förkasta planen.

Importerna är kopior, inte hardlinks

Symptom: doktorn säger att hardlinks (hårda länkar) inte fungerar, eller diskanvändningen fördubblas efter importer.

Orsak: nedladdnings- och biblioteksmapparna ligger på olika diskar eller monteringar, eller så kan disken inte göra hardlinks (DrivePool, många NAS- och SMB-resurser, Docker Desktop på Windows). Varje fil skrivs ändå en gång. Färdiga Usenet-nedladdningar flyttas när de ligger på samma disk som biblioteket.

Lösning: montera en gemensam överordnad mapp i containern i stället för separata. Se Mappar.

HolyArrs startar inte

Symptom: containern stannar eller startar om direkt.

Orsak: loggen nämner den. Vanliga orsaker: /config ligger på en nätverksresurs eller FUSE-sökväg, eller en trasig del.

Lösning:

1. Flytta /config till en lokal disk om loggen säger det. HolyArrs kör inte sin databas på en nätverksresurs.
2. Annars startar du i felsäkert läge, lagar det från Settings (Inställningar) och startar om som vanligt.

En funktion saknas

Symptom: en funktion som du har läst om finns inte i appen.

Orsak: den kan vara tillbakahållen i den här versionen.

Lösning: se Tillbakahållna funktioner.

Sidor saknar namn eller bilder

Symptom: titlar visas utan affischer eller detaljer.

Orsak: det går inte att nå metadataservern.

Lösning: kontrollera din DNS och brandvägg. Doktorns avsnitt Network visar om servern svarar.

För experter

Doktorns kontroller och alternativ

Doktorn körs inuti containern som samma användare som HolyArrs körs som, så den stöter på det som HolyArrs stöter på.

Avsnitt	Visar
App	Version, användare och grupp, umask, om den körs i en container.
Config folder	Ägare, rättigheter, ledigt utrymme, om den ligger på en lokal disk.
Library och download folders	Finns, ägare, skrivbar, ledigt utrymme, hardlinks mellan nedladdnings- och biblioteksmapparna.
Network	Om metadataserverns namn går att slå upp och om den svarar.
Clock	Tid, tidszon (TZ), en varning när klockan är uppenbart fel.

Alternativ	Vad det gör
-config <folder>	Kontrollerar en annan HolyArrs-konfigurationsmapp än /config.
-json	Skriver ut rapporten som JSON.

Utgångskod 0 betyder att inget misslyckades; 1 betyder att en rad säger FAIL. Rapporten visar aldrig nycklar, lösenord eller tokens. Den läser bara, förutom en liten testfil som den skriver och tar bort. Om den startas som root lämnar den också över konfigurationsmappen till PUID:PGID, som vid en vanlig start.

Om HolyArrs startar om hela tiden misslyckas docker exec. Kör doktorn i en ny container med samma mappar:

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

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

Mappkontroll vid start

Vid start kontrollerar HolyArrs sina mappar och loggar en sammanfattningsrad, till exempel folders: 4 ok, 1 not writable, och sedan en rad per problemmapp med en lösning. Kontrollen avbryts efter 3 sekunder så att starten aldrig hänger sig. En mapp som är för långsam att svara räknas som ej kontrollerad; det beror ofta på en disk som vaknar ur vila eller en långsam nätverksresurs. Doktorn kontrollerar den utan tidsgräns. Se Loggar.

Inget shell i imagen

Imagen innehåller bara HolyArrs-programmet, så den förblir liten och ger en angripare mindre att utnyttja. docker exec holyarrs sh misslyckas avsiktligt. För en närmare titt startar du en tillfällig hjälpare vid sidan av:

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

Den ser HolyArrs-processen, delar dess nätverk och har samma mappar på samma sökvägar. Den körs som root, så titta men ändra inget: en fil som skrivs som root kan bli oläsbar för HolyArrs. För att testa som HolyArrs-användaren lägger du till --user <PUID>:<PGID>.

Ta reda på versionen

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

Doktorns avsnitt App visar samma sak.

Relaterat

• Få support
• Loggar
• Hälsokontroller