Fejlfinding

Find dit symptom, læs årsagen og følg løsningen. Eksemplerne bruger containernavnet holyarrs; brug dit eget, hvis det er et andet.

De første 3 tjek

1. Følg loggen: docker logs -f holyarrs. Hemmeligheder er skjult. Tryk på Ctrl+C for at stoppe med at følge; containeren bliver ved med at køre.
2. Kør doctor: docker exec holyarrs /holyarrs doctor. Hver linje siger OK, WARN eller FAIL, og hver WARN eller FAIL fortæller, hvordan du retter den.
3. Stadig kørt fast? Download en supportpakke og spørg. Se Få hjælp.

Websiden kan ikke nås

Symptom: browseren kan ikke forbinde til http://your-server:6262.

Årsag: containeren er stoppet, porten er ikke koblet på, eller en proxy står i vejen.

Løsning:

1. Kør docker ps. Du bør kunne se holyarrs med 0.0.0.0:6262->6262.
2. Hvis den bliver ved med at genstarte, så læs docker logs holyarrs for at se årsagen.
3. Hvis du bruger en sti som /holyarrs, se Reverse proxy og URL base.

Adgang nægtet

Symptom: doctor siger, at en mappe ikke er skrivbar, eller import fejler med en rettighedsfejl.

Årsag: mappens ejer på hosten passer ikke med PUID og PGID.

Løsning: kør den chown, doctor foreslår, eller sæt PUID og PGID til mappens ejer. På en NAS skal du give den bruger læse- og skriveadgang i rettighedsskærmen. Se NAS, Synology og Unraid.

Intet downloades

Symptom: titler bliver ved med at mangle, og intet når din downloader.

Årsag: ingen kilde svarer, downloaderen er ikke forbundet, eller intet release består dine udvalgsregler.

Løsning:

1. Åbn Settings > Downloaders (indstillinger > downloadere) og klik på Test ved din downloader. Den bør bestå.
2. Åbn Settings > Sources (indstillinger > kilder) og klik på Test ved hver kilde.
3. Åbn Choose a release (vælg et release) på titlen for at se alle resultater og årsagerne til, at de ikke blev valgt.

Se Downloadere og Kilder.

Downloadet, men ikke importeret

Symptom: downloaden er færdig i din downloader, men titlen er ikke i dit bibliotek.

Årsag: HolyArrs kan ikke se filen på den samme sti, kan ikke skrive til biblioteksmappen, eller importen kræver en beslutning.

Løsning:

1. Giv HolyArrs og downloaderen den samme downloadmappe på den samme sti, for eksempel /downloads, eller sæt Downloader’s path og HolyArrs’ path på downloaderen.
2. Kør doctor og ret enhver FAIL på download- eller biblioteksmapperne.
3. Tjek downloadlisten for elementer markeret Needs a decision (kræver en beslutning), og godkend eller kassér planen.

Importer er kopier, ikke hardlinks

Symptom: doctor siger, at hardlinks (hårde koblinger) ikke virker, eller diskforbruget fordobles efter importer.

Årsag: download- og biblioteksmapper ligger på forskellige diske eller mounts, eller disken kan ikke lave hardlinks (DrivePool, mange NAS- og SMB-shares, Docker Desktop på Windows). Hver fil bliver stadig kun skrevet én gang. Færdige Usenet-downloads bliver flyttet, når de ligger på samme disk som biblioteket.

Løsning: mount én fælles overordnet mappe i containeren i stedet for flere adskilte. Se Mapper.

HolyArrs vil ikke starte

Symptom: containeren stopper eller genstarter med det samme.

Årsag: loggen nævner den. Almindelige årsager er /config på en netværksdeling eller FUSE-sti, eller en ødelagt del.

Løsning:

1. Flyt /config til en lokal disk, hvis loggen siger det. HolyArrs kører ikke sin database på en deling.
2. Ellers start i fejlsikret tilstand, ret det fra Settings (indstillinger), og genstart normalt.

En funktion mangler

Symptom: en funktion, du har læst om, er ikke i appen.

Årsag: den kan være tilbageholdt i denne version.

Løsning: se Tilbageholdte funktioner.

Sider uden navne eller billeder

Symptom: titler vises uden plakater eller detaljer.

Årsag: metadataserveren kan ikke nås.

Løsning: tjek din DNS og firewall. Afsnittet Network i doctor viser, om serveren svarer.

For erfarne

Doctor-tjek og valgmuligheder

Doctor kører inde i containeren som den samme bruger, HolyArrs kører som, så den rammer det samme som HolyArrs.

Afsnit	Viser
App	Version, bruger og gruppe, umask, om den kører i en container.
Config folder	Ejer, rettigheder, ledig plads, om den ligger på en lokal disk.
Library and download folders	Findes, ejer, skrivbar, ledig plads, hardlinks mellem download- og biblioteksmapper.
Network	Om metadataserverens navn kan slås op, og om den svarer.
Clock	Tid, tidszone (TZ), en advarsel når uret tydeligvis er forkert.

Valg	Hvad det gør
-config <folder>	Tjekker en anden HolyArrs-konfigurationsmappe end /config.
-json	Udskriver rapporten som JSON.

Exitkode 0 betyder, at intet fejlede; 1 betyder, at en linje siger FAIL. Rapporten viser aldrig nøgler, adgangskoder eller tokens. Den læser kun, bortset fra en lille testfil, den skriver og fjerner. Startet som root giver den også konfigurationsmappen til PUID:PGID, ligesom en normal start.

Hvis HolyArrs bliver ved med at genstarte, fejler docker exec. Kør doctor i en ny container med de samme mapper:

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.

Mappetjek ved start

Ved start tjekker HolyArrs sine mapper og logger én oversigtslinje, for eksempel folders: 4 ok, 1 not writable, derefter én linje pr. problemmappe med en løsning. Tjekket stopper efter 3 sekunder, så starten aldrig hænger. En mappe, der er for langsom til at svare, regnes som ikke tjekket; det er ofte en disk, der vågner fra dvale, eller en langsom netværksdeling. Doctor tjekker uden tidsgrænse. Se Logs.

Ingen shell i imaget

Imaget indeholder kun HolyArrs-programmet, så det forbliver småt og giver en angriber mindre at arbejde med. docker exec holyarrs sh fejler med vilje. For et nærmere kig kan du starte en midlertidig hjælper ved siden af:

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

Den ser HolyArrs-processen, deler dens netværk og har de samme mapper på de samme stier. Den kører som root, så kig, men ret ikke: en fil skrevet som root kan være ulæselig for HolyArrs. Tilføj --user <PUID>:<PGID> for at teste som HolyArrs-brugeren.

Find versionen

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

Afsnittet App i doctor viser det samme.

Se også

• Få hjælp
• Logs
• Tilstandstjek