Feilsøking

Finn symptomet ditt, les årsaken, følg løsningen. Eksemplene bruker containernavnet holyarrs. Bruk ditt eget hvis det er et annet.

First 3 checks (de 3 første sjekkene)

1. Følg loggen: docker logs -f holyarrs. Hemmeligheter er maskert. Trykk Ctrl+C for å slutte å følge loggen. Containeren fortsetter å kjøre.
2. Kjør doctor: docker exec holyarrs /holyarrs doctor. Hver linje sier OK, WARN eller FAIL, og hver WARN eller FAIL sier hvordan du fikser den.
3. Står du fortsatt fast? Last ned en supportpakke og spør. Se Få hjelp.

Får ikke åpnet nettsiden

Symptom: nettleseren får ikke kontakt med http://your-server:6262.

Årsak: containeren er stoppet, porten er ikke koblet til, eller en proxy står i veien.

Løsning:

1. Kjør docker ps. Du skal se holyarrs med 0.0.0.0:6262->6262.
2. Hvis den starter på nytt hele tiden, les docker logs holyarrs for å se hvorfor.
3. Hvis du bruker en sti som /holyarrs, se Reverse proxy og URL base.

Tilgang nektet

Symptom: doctor sier at en mappe ikke er skrivbar, eller importer feiler med en tillatelsesfeil.

Årsak: eieren av mappen på hosten stemmer ikke med PUID og PGID.

Løsning: kjør chown-kommandoen doctor foreslår, eller sett PUID og PGID til eieren av mappen. På en NAS gir du den brukeren lese- og skrivetilgang i tillatelsesskjermen. Se NAS, Synology og Unraid.

Ingenting lastes ned

Symptom: titler blir stående som manglende, og ingenting når nedlasteren din.

Årsak: ingen kilde svarer, nedlasteren er ikke koblet til, eller ingen release består valgreglene dine.

Løsning:

1. Åpne Settings > Downloaders (innstillinger > nedlastere) og trykk på Test på nedlasteren din. Den skal bestå.
2. Åpne Settings > Sources (innstillinger > kilder) og trykk på Test på hver kilde.
3. Åpne Choose a release (velg en release) på tittelen for å se alle resultatene og hvorfor de ikke ble valgt.

Se Nedlastere og Kilder.

Lastet ned, men ikke importert

Symptom: nedlastingen ble ferdig i nedlasteren din, men tittelen er ikke i biblioteket.

Årsak: HolyArrs ser ikke filen på den samme stien, kan ikke skrive til bibliotekmappen, eller importen krever en avgjørelse.

Løsning:

1. Gi HolyArrs og nedlasteren den samme nedlastingsmappen på den samme stien, for eksempel /downloads, eller sett Downloader’s path (nedlasterens sti) og HolyArrs’ path (stien til HolyArrs) på nedlasteren.
2. Kjør doctor og fiks alle FAIL på nedlastings- eller bibliotekmappene.
3. Se i nedlastingslisten etter elementer merket Needs a decision (krever en avgjørelse), og godkjenn eller forkast planen.

Importer er kopier, ikke hardlinks

Symptom: doctor sier at hardlinks ikke fungerer, eller diskbruken dobles etter importer.

Årsak: nedlastings- og bibliotekmappene ligger på forskjellige disker eller mounts, eller disken kan ikke lage hardlinks (DrivePool, mange NAS og SMB-ressurser, Docker Desktop på Windows). Hver fil blir likevel skrevet bare én gang. Ferdige Usenet-nedlastinger flyttes når de ligger på samme disk som biblioteket.

Løsning: monter én felles overordnet mappe i containeren i stedet for separate. Se Mapper.

HolyArrs starter ikke

Symptom: containeren stopper eller starter på nytt med en gang.

Årsak: loggen sier hva det er. Vanlige årsaker: /config ligger på en nettverksressurs eller en FUSE-sti, eller en del er ødelagt.

Løsning:

1. Flytt /config til en lokal disk hvis loggen sier det. HolyArrs kjører ikke databasen sin på en nettverksressurs.
2. Ellers starter du i sikkermodus, fikser det fra Settings (innstillinger) og starter på nytt som vanlig.

En funksjon mangler

Symptom: en funksjon du har lest om finnes ikke i appen.

Årsak: den kan være holdt tilbake i denne versjonen.

Løsning: se Funksjoner som er holdt tilbake.

Sidene har ingen navn eller bilder

Symptom: titler vises uten plakater eller detaljer.

Årsak: metadataserveren er ikke tilgjengelig.

Løsning: sjekk DNS og brannmur. Nettverksdelen i doctor viser om serveren svarer.

For viderekomne

Doctor-sjekker og valg

Doctor kjører inne i containeren som den samme brukeren HolyArrs kjører som, så den treffer det samme som HolyArrs treffer.

Del	Viser
App	Versjon, bruker og gruppe, umask, om den kjører i en container.
Konfigurasjonsmappe	Eier, tillatelser, ledig plass, om den ligger på en lokal disk.
Bibliotek- og nedlastingsmapper	Finnes, eier, skrivbar, ledig plass, hardlinks mellom nedlastings- og bibliotekmapper.
Nettverk	Om navnet på metadataserveren kan løses opp og om den svarer.
Klokke	Tid, tidssone (TZ), en advarsel når klokken tydelig er feil.

Valg	Hva det gjør
-config <folder>	Sjekker en annen HolyArrs-konfigurasjonsmappe enn /config.
-json	Skriver rapporten som JSON.

Avslutningskode 0 betyr at ingenting feilet. 1 betyr at en linje sier FAIL. Rapporten viser aldri nøkler, passord eller tokens. Den bare leser, bortsett fra en liten testfil som den skriver og fjerner. Hvis den startes som root, gir den også konfigurasjonsmappen til PUID:PGID, som en vanlig oppstart.

Hvis HolyArrs starter på nytt hele tiden, feiler docker exec. Kjør doctor i en ny container med de samme mappene:

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.

Sjekk av mapper ved oppstart

Ved oppstart sjekker HolyArrs mappene sine og logger én oppsummeringslinje, for eksempel folders: 4 ok, 1 not writable, og deretter én linje per problemmappe med en løsning. Sjekken stopper etter 3 sekunder, så oppstarten aldri henger. En mappe som svarer for sakte, regnes som ikke sjekket. Det er ofte en disk som våkner fra hvilemodus eller en treg nettverksressurs. Doctor sjekker den uten tidsgrense. Se Logger.

Ingen shell i imaget

Imaget inneholder bare HolyArrs-programmet, så det holder seg lite og gir en angriper mindre å gå på. docker exec holyarrs sh feiler med vilje. For å se nærmere på det starter du en midlertidig hjelper ved siden av:

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

Den ser HolyArrs-prosessen, deler nettverket og har de samme mappene på de samme stiene. Den kjører som root, så se, men ikke endre: en fil skrevet som root kan bli uleselig for HolyArrs. For å teste som HolyArrs-brukeren legger du til --user <PUID>:<PGID>.

Finn versjonen

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

App-delen i doctor viser det samme.

Relatert

• Få hjelp
• Logger
• Helsesjekker