NAS, Synology ja Unraid

Aja HolyArrs NAS-laitteellasi oikeilla kansioilla, omistajalla ja uudelleenkäynnistysasetuksella. Lue ensin Asennus.

Ennen kuin aloitat

• /config kuuluu paikalliselle volumelle tai poolille. Ei koskaan verkkojaolle.
• Media kuuluu yhteen jaettuun kansioon, jonka sisällä ovat downloads, movies, tv ja music. Liitä jokainen erikseen tai liitä ylätason kansio kerran hardlinkkejä (kova linkki) varten. Katso Kansiot.

Ota NAS käyttöön

::tab[Synology]

1. Tee File Stationissa docker/holyarrs/config.
2. Tee yksi jaettu kansio media, jonka sisällä ovat downloads, movies, tv ja music.
3. Avaa Container Managerissa Project > Create ja liitä Compose-tiedosto sivulta Asennus.
4. Aseta volumet muotoon /volume1/docker/holyarrs/config:/config, sitten /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music ja /volume1/media/downloads:/downloads.
5. Aseta PUID ja PGID käyttäjääsi vastaaviksi, usein 1026 ja 100. Tarkista SSH:n kautta komennolla id <user>.
6. Anna kyseiselle käyttäjälle luku- ja kirjoitusoikeus kansioon media: Control Panel > Shared Folder > Edit > Permissions.
7. Rastita Enable auto-restart.
8. Avaa http://your-server:6262. Näet ensimmäisen käynnistyksen ohjatun toiminnon. Lisää /movies, /tv ja /music kirjastokansioiksi.

::tab[Unraid]

Community Applications -mallia ei vielä ole, joten lisää container käsin.

1. Lisää Docker-välilehdellä container HolyArrsin imagella.
2. Yhdistä portti 6262.
3. Yhdistä /config poolin polkuun, esimerkiksi /mnt/<pool>/appdata/holyarrs. <pool> on poolisi nimi. Ei /mnt/user/appdata.
4. Yhdistä mediakansiosi kohteisiin /movies, /tv, /music ja /downloads käyttäen levyn tai poolin polkuja, esimerkiksi /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music ja /mnt/<pool>/media/downloads:/downloads.
5. Aseta PUID=99, PGID=100 (Unraidin nobody:users) ja UMASK=022.
6. Ota containerille käyttöön automaattinen käynnistys, jotta se käynnistyy uudelleen itsestään.
7. Avaa http://your-server:6262. Näet ensimmäisen käynnistyksen ohjatun toiminnon.

::tab[QNAP]

1. Tee Container/holyarrs/config ja yksi media-jako, jonka sisällä ovat downloads, movies, tv ja music.
2. Avaa Container Stationissa Applications > Create ja liitä Compose-tiedosto.
3. Käytä /share/Container/holyarrs/config:/config, sitten /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music ja /share/media/downloads:/downloads.
4. Aseta PUID ja PGID jaon media omistajaa vastaaviksi.
5. Aseta uudelleenkäynnistyskäytännöksi unless-stopped.
6. Avaa http://your-server:6262. Näet ensimmäisen käynnistyksen ohjatun toiminnon.

::tab[TrueNAS SCALE]

1. Tee 2 datasettiä: apps/holyarrs-config ja media, ja kansiot downloads, movies, tv ja music kansion media sisälle.
2. Lisää Appsissa oma sovellus YAMLista Compose-tiedostolla.
3. Käytä /mnt/<pool>/apps/holyarrs-config:/config, sitten /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music ja /mnt/<pool>/media/downloads:/downloads.
4. Aseta PUID ja PGID datasetin omistajaa vastaaviksi, usein 568. Anna kyseiselle käyttäjälle kirjoitusoikeus datasetin ACL:ssä.
5. Aseta uudelleenkäynnistyskäytännöksi unless-stopped.
6. Avaa http://your-server:6262. Näet ensimmäisen käynnistyksen ohjatun toiminnon.

Jokainen NAS: anna PUID-käyttäjälle luku- ja kirjoitusoikeus mediakansioon NAS-laitteen oikeusnäkymässä; HolyArrs hoitaa asetuskansion itse. Ota containerille käyttöön automaattinen uudelleenkäynnistys (Dockerin käytäntö unless-stopped).

Hardlinkit eivät vie lisätilaa ja valmistuvat heti. Niitä varten liitä se yksi mediakansio neljän tilalle ja anna latausohjelmallesi sama liitos samaan polkuun. Katso Mediakansiot.

Vaihtoehdot

Erilliset liitokset

Kansioiden /movies, /tv, /music ja /downloads liittäminen yksi kerrallaan toimii, mutta jokaisesta tuonnista tulee täysi kopio. Jokainen liitos on oma tiedostojärjestelmänsä containerin sisällä, eikä hardlink voi ylittää tiedostojärjestelmiä. Erilliset jaot tai datasetit saman ylätason kansion alla kopioivat myös. Sivu Settings > Library folders (asetukset > kirjastokansiot) varoittaa, kun HolyArrsin täytyy kopioida.

Anna levyjesi nukkua

Nämä tehtävät herättävät medialevyt. Muuta niiden ajotiheyttä sivulla Schedules (aikataulut).

Tehtävä	Mitä se lukee
Rescan the Library (skannaa kirjasto uudelleen)	Jokaisen kirjastokansion. Herättää levyt eniten.
Check Library folders (tarkista kirjastokansiot)	Jokaisen kansion tiedot ja vapaan tilan. Kirjoitus- ja hardlink-testi ajetaan vain käynnistyksessä, kohdassa Run now (aja nyt) ja kansioiden muuttuessa.
Look for missing subtitles (etsi puuttuvia tekstityksiä), Look for better subtitles (etsi parempia tekstityksiä)	Jokaisen videon vieressä olevan kansion.

• Laita /config ja latauskansio SSD-levylle tai välimuistipoolille.
• Pidä 1 Gt vapaana levyllä, jolla /config on. Sen alle jäädessä saat kuntovaroituksen.
• Unraidilla Cache Directories -lisäosa pitää kansiolistaukset muistissa, joten skannaukset ohittavat levyn.
• Tuonnit, lisäykset ja poistot koskevat levyä, jolla ne tapahtuvat, silloin kun ne tapahtuvat.
• Aseta uudelleenskannaus 7 päivän välein tai pois. Käsin lisäämäsi tiedostot löytyvät silloin vain, kun napsautat Run now kohdassa Rescan the Library.
• Jaossa oleva torrentti lukee tiedostoaan. Jos se on hardlinkattu kirjastoosi, kyseinen levy pysyy hereillä, kunnes jako päättyy.

Jos se ei toimi

Oire	Syy	Ratkaisu
Ei käynnisty, mainitsee FUSE-polun, verkkojaon tai Unraidin user sharen	/config ei ole paikallisella levyllä (Unraidilla se osoittaa kohtaan /mnt/user)	Siirrä /config paikalliselle levylle tai poolin polkuun, esimerkiksi /mnt/<pool>/appdata/holyarrs.
Pysyy pysäytettynä uudelleenkäynnistyksen tai palautuksen jälkeen	Automaattinen uudelleenkäynnistys on pois	Ota se käyttöön ja käynnistä container.
Tuonnit epäonnistuvat oikeusvirheeseen	PUID-käyttäjä ei voi kirjoittaa mediaan	Anna sille luku- ja kirjoitusoikeus NAS-laitteen oikeusnäkymässä (Synologyllä: Control Panel > Shared Folder > Edit > Permissions).
Tuonnit ovat kopioita, eivät hardlinkkejä	Lataukset ja kirjasto ovat eri liitoksissa tai levyillä	Liitä yksi jaettu kansio kerran, sekä HolyArrsiin että latausohjelmaan.

Lisää ratkaisuja: Vianmääritys.

Asiantuntijoille

Miksi HolyArrs hylkää joitakin asetuspolkuja

HolyArrs pitää tietokantansa kansiossa /config. Verkkojaot ja FUSE-polut voivat vioittaa niitä, joten HolyArrs kieltäytyy käynnistymästä sellaisella ja kertoo syyn.

Unraidilla /mnt/user on FUSE-polku. Käytä poolin polkua tai tee appdatasta Exclusive: ota käyttöön Permit exclusive shares kohdassa Settings > Global Share Settings ja aseta sitten Shares > appdata ensisijaiseksi tallennustilaksi yhdellä poolilla ja toissijaiseksi tallennustilaksi ei mitään.

/config-polku poolilla, jota ei ole, päätyy muistiin ja katoaa uudelleenkäynnistyksessä. HolyArrs hylkää senkin. Vältä /mnt/user-polkua myös medialle; hardlinkit sen yli voivat epäonnistua.

Miksi automaattinen uudelleenkäynnistys on tärkeä

Uudelleenkäynnistys sovelluksessa, vikasietotila ja varmuuskopion palautus pysäyttävät HolyArrsin ja odottavat, että Docker käynnistää sen uudelleen. Ilman automaattista uudelleenkäynnistystä se pysyy pysäytettynä. Katso Osat ja vikasietotila.

Portti ja päivitykset

• Yhdistä portti 6262 vain kotiverkkoosi. Lue Tietoturvan perusteet ennen kuin avaat sen kenellekään ulkopuoliselle.
• Päivitä hakemalla uusi image ja luomalla container uudelleen. Tietosi pysyvät kansiossa /config. Katso Päivitykset.

Aiheesta lisää

• Kansiot
• Kirjastokansiot
• Aikataulut