Delar och felsäkert läge

Stäng av de delar du inte använder, starta i felsäkert läge när något går sönder och starta om HolyArrs från webbläsaren.

Slå på eller av en del

HolyArrs har 5 delar: Movies (filmer), TV shows (serier), Music (musik), Subtitles (undertexter) och Requests (förfrågningar). Du väljer dem första gången i guiden vid första start.

1. Öppna Settings > Parts (inställningar > delar).
2. Klicka på Turn on (slå på) eller Turn off (slå av) bredvid en del. Du ska se dess menyval dyka upp eller försvinna.

Inget raderas. Slå på en del igen så fortsätter den där den slutade.

Starta i felsäkert läge

Felsäkert läge startar bara grunderna, för när något hindrar HolyArrs från att starta eller fungera. Du kan logga in, titta på ditt bibliotek, ändra inställningar och göra eller återställa en backup. Sökning, tillägg, uppdateringar, nedladdning och import väntar till nästa normala start.

1. Öppna Settings > Danger zone (inställningar > farozon).
2. Klicka på Restart in safe mode (starta om i felsäkert läge). Du ska se en banderoll på varje sida.
3. Åtgärda problemet och klicka sedan på Restart HolyArrs (starta om HolyArrs). Nästa start är normal.

Om du inte kommer åt sidan sätter du HOLYARRS_SAFE_MODE=1 i Compose eller startar med -safe-mode. Ta bort det efter åtgärden: båda gör att varje start sker i felsäkert läge.

Val

Vad som stannar när en del är av

Del	Stannar	Fortsätter
Filmer	Filmsidor och menyval, tillägg, sökning, uppdateringar	Nedladdningar som redan finns i din nedladdare följs fortfarande. Filerna ligger kvar.
Serier	Seriesidor, tillägg, sökning, säsongssökningar, uppdateringar	Samma som Filmer.
Musik	Artist- och albumsidor, musikinställningar, artistuppdateringar, albumsökningar	Samma som Filmer.
Undertexter	Undertextinställningar, sidan för saknade undertexter, sökningar och kontroller	Undertextfiler bredvid dina videor ligger kvar.
Förfrågningar	Förfrågningssidor och möjligheten att be om titlar	Befintliga förfrågningar ligger kvar och kommer tillbaka när delen är på igen.

Alltid på: inloggning och konton, biblioteksmappar, källor, nedladdare och nedladdningar, aviseringar, historik, backuper, hälsokontroller, inställningar och API:et.

• Undertexter kräver Filmer eller Serier. Förfrågningar kräver Filmer, Serier eller Musik. HolyArrs nekar en ändring som bryter mot det och säger vad du ska ändra först.
• Ett köat jobb för en del som är av väntar och körs när delen är på.
• Att stänga av en del sparar inget minne. Allt körs i ett enda program.

Starta om, pausa och stäng av

Settings > Danger zone (ägare och admins) har Restart HolyArrs, Restart in safe mode och Shut down (stäng av), plus Pause (pausa), Resume (återuppta) och Restart för varje bakgrundsuppgift, till exempel backuper eller synkning av nedladdningar.

• Kontroller som stoppar något ber dig bekräfta inom 60 s.
• Varje kontroll som används skrivs till Historik med ditt namn.
• Du behöver en inloggning med lösenord. En inloggning utan lösenord på ditt lokala nätverk nekas.

Omstart stoppar HolyArrs rent och låter Docker starta det igen, så sätt restart: unless-stopped.

Omstartspolicy	Omstart	Avstängning
unless-stopped eller always	Kommer tillbaka	Kommer tillbaka också
on-failure	Kommer tillbaka	Förblir nere
no	Förblir nere	Förblir nere

Om det inte fungerar

Symptom	Orsak	Lösning
HolyArrs kan inte stänga av en del	En annan del behöver den	Stäng av den delen först, som meddelandet säger.
Omstarten stängde av HolyArrs för gott	Omstartspolicyn är no	Starta containern och sätt restart: unless-stopped.
Kontrollerna nekas	Lokal inloggning utan lösenord, eller nyckeln saknar control	Logga in med ditt lösenord.
En uppgift förblir misslyckad	Den behöver dig	Läs orsaken på /health, åtgärda den och klicka på Restart för den uppgiften.

Fler lösningar: Felsökning.

För experter

Hälsotillstånd

/health, Settings > Parts och GET /api/v1/health/states listar varje bakgrundsuppgift, del och länkad app med ett tillstånd och en orsak.

Tillstånd	Betydelse
off	Avstängd, pausad eller inte startad i felsäkert läge.
starting	Startar, eller inte kontrollerad ännu.
running	Fungerar.
retrying	Misslyckades; HolyArrs försöker igen och väntar längre varje gång.
failed	Kraschade, har fastnat eller behöver dig. Orsaken säger vad du ska göra.

En kraschad uppgift visar failed, sedan retrying och startar sedan igen. Inloggning, biblioteket och backuper fungerar under tiden. En uppgift som har fastnat löses vid en full omstart.

Minne och läge för lite minne

HolyArrs siktar på att hålla sig under 384 MiB, vilket ryms i en containergräns på 500 MB. För att sätta ditt eget mål sätter du GOMEMLIMIT till ungefär 80 procent av containerns minne.

Läget för lite minne håller mindre i minnet och läser mer från databasen. Vissa sidor tar en stund längre, och bakgrundsarbete som kopieringen av musikkatalogen körs mer sällan.

Inställning	Effekt
(standard, Linux)	Slås på av sig självt vid ungefär 2,5 GiB minne eller mindre.
HOLYARRS_LOW_MEMORY=1	Alltid på.
HOLYARRS_LOW_MEMORY=0	Alltid av.

Den första loggraden säger om det är på och varför.

Scope för API-nycklar

Skapa en nyckel i Settings > API > API keys (inställningar > API > API-nycklar) och skicka den i headern X-Api-Key.

Scope	Når
read	Bibliotek, jobb, nedladdningar, historik, hälsa, inställningar. Hemligheter maskerade.
health_read	Bara hälsotillstånd. För övervakningsverktyg.
write	Varje ändring utom admin-routes och kontroller.
admin	Personer, inbjudningar, förfrågningsgränser, API-nycklar, lösenord och tvåfaktor, inloggningsinställningar, backuper.
control	Kontrollerna på den här sidan. Bara ägaren och admins kan ge den.
all	read, write och admin. Inte control.

En nyckel gör aldrig mer än personen som skapade den. Scope kan inte ändras senare; skapa en ny nyckel. Varje route och dess scope: /api/v1/openapi.json.

Relaterat

• Hälsokontroller
• Backuper
• API-routes