Dele og fejlsikret tilstand

Slå de dele fra, du ikke bruger, start i fejlsikret tilstand, når noget går i stykker, og genstart HolyArrs fra browseren.

Slå en del til eller fra

HolyArrs har 5 dele: Movies (film), TV shows (serier), Music (musik), Subtitles (undertekster) og Requests (ønsker). Du vælger dem første gang i guiden ved første start.

1. Åbn Settings > Parts (Indstillinger > Dele).
2. Klik på Turn on (slå til) eller Turn off (slå fra) ud for en del. Du bør kunne se dens menupunkter dukke op eller forsvinde.

Der bliver ikke slettet noget. Slår du en del til igen, fortsætter den, hvor den slap.

Start i fejlsikret tilstand

Fejlsikret tilstand starter kun det helt nødvendige, til når noget forhindrer HolyArrs i at starte eller virke. Du kan logge ind, se dit bibliotek, ændre indstillinger og tage eller gendanne en backup. Søgning, tilføjelse, opdatering, download og import venter til næste normale start.

1. Åbn Settings > Danger zone (Indstillinger > Farezone).
2. Klik på Restart in safe mode (genstart i fejlsikret tilstand). Du bør kunne se et banner på hver side.
3. Ret problemet, og klik derefter på Restart HolyArrs (genstart HolyArrs). Den næste start er normal.

Kan du ikke nå siden, så sæt HOLYARRS_SAFE_MODE=1 i Compose eller start med -safe-mode. Fjern det igen efter rettelsen: begge dele holder hver start i fejlsikret tilstand.

Valg

Hvad der stopper, når en del er slået fra

Del	Stopper	Kører videre
Film	Filmsider og menupunkter, tilføjelse, søgning, opdatering	Downloads, der allerede ligger i din downloader, bliver stadig fulgt. Filerne bliver liggende.
Serier	Seriesider, tilføjelse, søgning, sæsonsøgninger, opdateringer	Som film.
Musik	Kunstner- og albumsider, musikindstillinger, opdatering af kunstnere, albumsøgninger	Som film.
Undertekster	Undertekstindstillinger, siden med manglende undertekster, søgninger og tjek	Undertekstfiler ved siden af dine videoer bliver liggende.
Ønsker	Ønskesider og at ønske titler	Eksisterende ønsker bliver liggende og kommer tilbage, når delen er slået til igen.

Altid slået til: login og konti, biblioteksmapper, kilder, downloadere og downloads, beskeder, historik, backups, tilstandstjek, indstillinger og API’et.

• Undertekster kræver film eller serier. Ønsker kræver film, serier eller musik. HolyArrs afviser en ændring, der bryder det, og siger, hvad du skal ændre først.
• En opgave i kø for en del, der er slået fra, venter og kører, når delen er slået til.
• At slå en del fra sparer ikke hukommelse. Alt kører i ét program.

Genstart, pause og luk ned

Settings > Danger zone (ejer og admins) har Restart HolyArrs, Restart in safe mode og Shut down (luk ned), plus Pause (pause), Resume (genoptag) og Restart (genstart) for hver baggrundsopgave, for eksempel backups eller synkronisering af downloads.

• Knapper, der stopper noget, beder dig bekræfte inden for 60 sek.
• Hver brugt knap bliver skrevet i historikken med dit navn.
• Du skal være logget ind med adgangskode. Et login uden adgangskode på dit lokale netværk bliver afvist.

Genstart stopper HolyArrs rent og lader Docker starte den igen, så sæt restart: unless-stopped.

Genstartspolitik	Genstart	Luk ned
unless-stopped eller always	Kommer tilbage	Kommer også tilbage
on-failure	Kommer tilbage	Forbliver nede
no	Forbliver nede	Forbliver nede

Hvis det ikke virker

Symptom	Årsag	Løsning
HolyArrs kan ikke slå en del fra	En anden del har brug for den	Slå den anden del fra først, som beskeden siger.
Genstart lukkede HolyArrs ned for altid	Genstartspolitikken er no	Start containeren og sæt restart: unless-stopped.
Knapperne bliver afvist	Lokalt login uden adgangskode, eller nøglen mangler control	Log ind med din adgangskode.
En opgave bliver ved med at være mislykket	Den har brug for dig	Læs årsagen på /health, ret det, og klik på Restart for den opgave.

Flere løsninger: Fejlfinding.

For erfarne

Tilstande

/health, Settings > Parts og GET /api/v1/health/states viser hver baggrundsopgave, del og forbundne app med en tilstand og en årsag.

Tilstand	Betydning
off	Slået fra, sat på pause eller ikke startet i fejlsikret tilstand.
starting	Starter, eller er ikke tjekket endnu.
running	Virker.
retrying	Mislykkedes; HolyArrs prøver igen og venter længere hver gang.
failed	Gik ned, sidder fast eller har brug for dig. Årsagen siger, hvad du skal gøre.

En opgave, der går ned, viser failed, derefter retrying, og starter så igen. Login, biblioteket og backups virker imens. En opgave, der sidder fast, bliver løst ved en fuld genstart.

Hukommelse og tilstand til lav hukommelse

HolyArrs sigter efter at holde sig under 384 MiB, hvilket passer til en containergrænse på 500 MB. Vil du sætte dit eget mål, så sæt GOMEMLIMIT til omkring 80 procent af containerens hukommelse.

Tilstanden til lav hukommelse gemmer mindre i hukommelsen og læser mere fra databasen. Nogle sider tager lidt længere tid, og baggrundsarbejde som kopien af musikkataloget kører sjældnere.

Indstilling	Virkning
(standard, Linux)	Slår sig selv til ved cirka 2,5 GiB hukommelse eller mindre.
HOLYARRS_LOW_MEMORY=1	Altid til.
HOLYARRS_LOW_MEMORY=0	Altid fra.

Den første loglinje siger, om den er slået til, og hvorfor.

Scopes for API-nøgler

Lav en nøgle under Settings > API > API keys (API-nøgler) og send den i headeren X-Api-Key.

Scope	Giver adgang til
read	Bibliotek, opgaver, downloads, historik, tilstand, indstillinger. Hemmeligheder er skjult.
health_read	Kun tilstande. Til overvågningsværktøjer.
write	Alle ændringer undtagen admin-ruter og knapper.
admin	Personer, invitationer, ønskegrænser, API-nøgler, adgangskode og totrinsbekræftelse, loginindstillinger, backups.
control	Knapperne på denne side. Kun ejeren og adminerne kan give den.
all	read, write og admin. Ikke control.

En nøgle kan aldrig mere end den person, der har lavet den. Scopes kan ikke ændres bagefter; lav en ny nøgle. Alle ruter og deres scope: /api/v1/openapi.json.

Se også

• Tilstandstjek
• Backups
• API-ruter