Vianmääritys

Etsi oirettasi vastaava kohta, lue syy ja seuraa ratkaisua. Esimerkeissä containerin nimi on holyarrs. Käytä omaasi, jos se on eri.

Kolme ensimmäistä tarkistusta

1. Seuraa lokia: docker logs -f holyarrs. Salaisuudet on peitetty. Lopeta seuranta painamalla Ctrl+C. Container jatkaa toimintaa.
2. Suorita doctor: docker exec holyarrs /holyarrs doctor. Jokaisella rivillä lukee OK, WARN tai FAIL, ja jokaisen WARN- tai FAIL-rivin kohdalla kerrotaan, miten sen korjaa.
3. Vieläkö jumissa? Lataa tukipaketti ja kysy apua. Katso Tuen saaminen.

Verkkosivu ei aukea

Oire: selain ei yhdistä osoitteeseen http://your-server:6262.

Syy: container on pysäytetty, porttia ei ole yhdistetty tai välissä on proxy.

Ratkaisu:

1. Suorita docker ps. Näet holyarrs-rivin ja 0.0.0.0:6262->6262.
2. Jos container käynnistyy koko ajan uudelleen, lue syy komennolla docker logs holyarrs.
3. Jos käytät polkua, esimerkiksi /holyarrs, katso Reverse proxy ja URL base.

Permission denied -virhe

Oire: doctor sanoo, ettei kansioon voi kirjoittaa, tai tuonnit epäonnistuvat oikeusvirheeseen.

Syy: kansion omistaja isäntäkoneella ei vastaa arvoja PUID ja PGID.

Ratkaisu: suorita chown, jonka doctor ehdottaa, tai aseta PUID ja PGID kansion omistajan mukaan. NAS-laitteella anna kyseiselle käyttäjälle luku- ja kirjoitusoikeus oikeuksien näytöllä. Katso NAS, Synology ja Unraid.

Mikään ei lataudu

Oire: nimikkeet pysyvät puuttuvina eikä mitään tule latausohjelmaasi.

Syy: mikään lähde ei vastaa, latausohjelmaa ei ole yhdistetty tai yksikään julkaisu ei läpäise valintasääntöjäsi.

Ratkaisu:

1. Avaa Settings > Downloaders (asetukset > latausohjelmat) ja napsauta latausohjelmasi kohdalla Test (testaa). Testin pitäisi mennä läpi.
2. Avaa Settings > Sources (asetukset > lähteet) ja napsauta Test jokaisen lähteen kohdalla.
3. Avaa nimikkeellä Choose a release (valitse julkaisu) nähdäksesi kaikki tulokset ja syyt, miksi mitään ei valittu.

Katso Latausohjelmat ja Lähteet.

Ladattu mutta ei tuotu

Oire: lataus valmistui latausohjelmassa, mutta nimike ei ole kirjastossasi.

Syy: HolyArrs ei näe tiedostoa samassa polussa, ei voi kirjoittaa kirjastokansioon tai tuonti vaatii päätöksen.

Ratkaisu:

1. Anna HolyArrsille ja latausohjelmalle sama latauskansio samassa polussa, esimerkiksi /downloads, tai aseta latausohjelmalle Downloader’s path (latausohjelman polku) ja HolyArrs’ path (HolyArrsin polku).
2. Suorita doctor ja korjaa kaikki FAIL-rivit, jotka koskevat lataus- tai kirjastokansioita.
3. Tarkista latauslistasta kohteet, joissa lukee Needs a decision (vaatii päätöksen), ja hyväksy tai hylkää suunnitelma.

Tuonnit ovat kopioita, eivät hardlinkejä

Oire: doctor sanoo, etteivät hardlinkit (kova linkki) toimi, tai levyn käyttö kaksinkertaistuu tuonnin jälkeen.

Syy: lataus- ja kirjastokansiot ovat eri levyillä tai liitoksissa, tai levy ei osaa tehdä hardlinkkejä (DrivePool, monet NAS- ja SMB-jaot, Docker Desktop Windowsissa). Jokainen tiedosto kirjoitetaan silti vain kerran. Valmiit Usenet-lataukset siirretään, kun ne ovat samalla levyllä kuin kirjasto.

Ratkaisu: liitä containeriin yksi yhteinen ylätason kansio erillisten sijaan. Katso Kansiot.

HolyArrs ei käynnisty

Oire: container pysähtyy tai käynnistyy heti uudelleen.

Syy: loki kertoo sen. Yleisiä syitä: /config on verkkojaolla tai FUSE-polussa tai jokin osa on rikki.

Ratkaisu:

1. Siirrä /config paikalliselle levylle, jos loki niin sanoo. HolyArrs ei aja tietokantaansa verkkojaolla.
2. Muuten käynnistä vikasietotilassa, korjaa asia kohdasta Settings (asetukset) ja käynnistä sitten normaalisti uudelleen.

Ominaisuus puuttuu

Oire: ominaisuus, josta luit, ei ole sovelluksessa.

Syy: se voi olla myöhemmäksi jätetty tässä versiossa.

Ratkaisu: katso Myöhemmäksi jätetyt ominaisuudet.

Sivuilla ei ole nimiä tai kuvia

Oire: nimikkeet näkyvät ilman julisteita tai tietoja.

Syy: metadatapalvelimeen ei saada yhteyttä.

Ratkaisu: tarkista DNS ja palomuuri. Doctorin Network-osiosta näet, vastaako palvelin.

Asiantuntijoille

Doctorin tarkistukset ja valinnat

Doctor toimii containerin sisällä samana käyttäjänä kuin HolyArrs, joten se törmää samoihin asioihin kuin HolyArrs.

Osio	Näyttää
App	Versio, käyttäjä ja ryhmä, umask, toimiiko se containerissa.
Config folder	Omistaja, oikeudet, vapaa tila, onko se paikallisella levyllä.
Library and download folders	Onko olemassa, omistaja, kirjoitettavissa, vapaa tila, hardlinkit lataus- ja kirjastokansioiden välillä.
Network	Selviääkö metadatapalvelimen nimi ja vastaako se.
Clock	Aika, aikavyöhyke (TZ), varoitus, jos kello on selvästi väärässä.

Valinta	Mitä se tekee
-config <folder>	Tarkistaa muun HolyArrsin asetuskansion kuin /config.
-json	Tulostaa raportin JSON-muodossa.

Poistumiskoodi 0 tarkoittaa, ettei mikään epäonnistunut. 1 tarkoittaa, että jollakin rivillä lukee FAIL. Raportti ei koskaan näytä avaimia, salasanoja tai tokeneita. Se vain lukee, paitsi pienen testitiedoston, jonka se kirjoittaa ja poistaa. Jos se käynnistetään root-käyttäjänä, se antaa myös asetuskansion käyttäjälle PUID:PGID, kuten normaali käynnistys.

Jos HolyArrs käynnistyy koko ajan uudelleen, docker exec epäonnistuu. Suorita doctor uudessa containerissa samoilla kansioilla:

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

Composella: docker compose run --rm holyarrs doctor.

Käynnistyksen kansiotarkistus

Käynnistyessään HolyArrs tarkistaa kansionsa ja kirjaa yhden yhteenvetorivin, esimerkiksi folders: 4 ok, 1 not writable, ja sitten yhden rivin jokaisesta ongelmakansiosta ratkaisun kera. Tarkistus loppuu kolmen sekunnin kuluttua, joten käynnistys ei koskaan jää jumiin. Kansio, joka vastaa liian hitaasti, lasketaan tarkistamattomaksi. Syy on usein unesta heräävä levy tai hidas verkkojako. Doctor tarkistaa sen ilman aikarajaa. Katso Lokit.

Imagessa ei ole shelliä

Image sisältää vain HolyArrs-ohjelman, joten se pysyy pienenä ja hyökkääjälle jää vähemmän. docker exec holyarrs sh epäonnistuu tarkoituksella. Tarkempaa katsomista varten käynnistä väliaikainen apucontainer sen viereen:

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

Se näkee HolyArrsin prosessin, jakaa sen verkon ja sillä on samat kansiot samoissa poluissa. Se toimii root-käyttäjänä, joten vain katso äläkä muuta mitään: root-käyttäjänä kirjoitettu tiedosto voi jäädä HolyArrsille lukukelvottomaksi. Jos haluat testata HolyArrsin käyttäjänä, lisää --user <PUID>:<PGID>.

Selvitä versio

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

Doctorin App-osio näyttää saman.

Aiheesta lisää

• Tuen saaminen
• Lokit
• Kuntotarkistukset