Onderdelen en veilige modus

Zet de onderdelen uit die je niet gebruikt, start in veilige modus als er iets kapotgaat en herstart HolyArrs vanuit de browser.

Een onderdeel aan- of uitzetten

HolyArrs heeft 5 onderdelen: Movies (films), TV shows (series), Music (muziek), Subtitles (ondertitels) en Requests (aanvragen). Je kiest ze voor het eerst in de wizard bij de eerste start.

1. Open Settings > Parts (Instellingen > Onderdelen).
2. Klik naast een onderdeel op Turn on (aanzetten) of Turn off (uitzetten). De menu-items van dat onderdeel verschijnen of verdwijnen nu.

Er wordt niets verwijderd. Zet je een onderdeel weer aan, dan gaat het verder waar het was gebleven.

Starten in veilige modus

Veilige modus start alleen het hoogstnodige, voor als iets HolyArrs belet te starten of te werken. Je kunt aanmelden, je bibliotheek bekijken, instellingen wijzigen en een backup maken of terugzetten. Zoeken, toevoegen, verversen, downloaden en importeren wachten tot de volgende normale start.

1. Open Settings > Danger zone (Instellingen > Gevarenzone).
2. Klik op Restart in safe mode (herstarten in veilige modus). Je ziet nu op elke pagina een banner.
3. Los het probleem op en klik dan op Restart HolyArrs (HolyArrs herstarten). De volgende start is normaal.

Kom je niet bij de pagina, zet dan HOLYARRS_SAFE_MODE=1 in Compose of start met -safe-mode. Haal het weg zodra het probleem is opgelost: beide houden elke start in veilige modus.

Keuzes

Wat stopt als een onderdeel uit staat

Onderdeel	Stopt	Blijft doorgaan
Films	Filmpagina’s en menu-items, toevoegen, zoeken, verversen	Downloads die al in je downloader staan, worden nog gevolgd. Bestanden blijven staan.
Series	Seriepagina’s, toevoegen, zoeken, seizoenen zoeken, verversen	Hetzelfde als bij Films.
Muziek	Artiest- en albumpagina’s, muziekinstellingen, artiesten verversen, albums zoeken	Hetzelfde als bij Films.
Ondertitels	Ondertitelinstellingen, de pagina met ontbrekende ondertitels, zoeken en controles	Ondertitelbestanden naast je video’s blijven staan.
Aanvragen	Aanvraagpagina’s en titels aanvragen	Bestaande aanvragen blijven staan en komen terug als het onderdeel weer aan staat.

Altijd aan: aanmelden en accounts, bibliotheekmappen, bronnen, downloaders en downloads, meldingen, geschiedenis, backups, gezondheidscontroles, instellingen en de API.

• Ondertitels hebben Films of Series nodig. Aanvragen hebben Films, Series of Muziek nodig. HolyArrs weigert een wijziging die dit breekt en zegt wat je eerst moet wijzigen.
• Een taak in de wachtrij voor een onderdeel dat uit staat, wacht en draait zodra het onderdeel weer aan staat.
• Een onderdeel uitzetten bespaart geen geheugen. Alles draait in één programma.

Herstarten, pauzeren en afsluiten

Settings > Danger zone (eigenaar en beheerders) heeft Restart HolyArrs, Restart in safe mode en Shut down (afsluiten), plus Pause (pauzeren), Resume (hervatten) en Restart voor elke achtergrondtaak, zoals backups of het synchroniseren van downloads.

• Knoppen die iets stoppen vragen je binnen 60 s om te bevestigen.
• Elke gebruikte knop komt met jouw naam in de Geschiedenis.
• Je moet met wachtwoord zijn aangemeld. Een aanmelding zonder wachtwoord op je lokale netwerk wordt geweigerd.

Herstarten stopt HolyArrs netjes en laat Docker het opnieuw starten, dus stel restart: unless-stopped in.

Herstartbeleid	Herstarten	Afsluiten
unless-stopped of always	Komt terug	Komt ook terug
on-failure	Komt terug	Blijft uit
no	Blijft uit	Blijft uit

Als het niet werkt

Symptoom	Oorzaak	Oplossing
HolyArrs kan een onderdeel niet uitzetten	Een ander onderdeel heeft het nodig	Zet eerst dat onderdeel uit, zoals de melding zegt.
Herstarten heeft HolyArrs voorgoed afgesloten	Herstartbeleid is no	Start de container en stel restart: unless-stopped in.
Knoppen worden geweigerd	Lokale aanmelding zonder wachtwoord, of de sleutel mist control	Meld je aan met je wachtwoord.
Een taak blijft mislukt	Er is jouw hulp nodig	Lees de reden op /health, los het op en klik op Restart bij die taak.

Meer oplossingen: Problemen oplossen.

Voor gevorderden

Gezondheidsstatus

/health, Settings > Parts en GET /api/v1/health/states tonen elke achtergrondtaak, elk onderdeel en elke gekoppelde app met een status en een reden.

Status	Betekenis
off	Uitgezet, gepauzeerd of niet gestart in veilige modus.
starting	Wordt gestart, of nog niet gecontroleerd.
running	Werkt.
retrying	Mislukt; HolyArrs probeert het opnieuw en wacht elke keer langer.
failed	Gecrasht, vastgelopen of heeft jou nodig. De reden zegt wat je moet doen.

Een gecrashte taak toont failed, dan retrying en start dan weer. Aanmelden, de bibliotheek en backups blijven ondertussen werken. Een vastgelopen taak verdwijnt na een volledige herstart.

Geheugen en modus voor weinig geheugen

HolyArrs streeft ernaar onder 384 MiB te blijven, wat past in een containerlimiet van 500 MB. Wil je een eigen doel instellen, zet GOMEMLIMIT dan op ongeveer 80 procent van het geheugen van de container.

De modus voor weinig geheugen houdt minder in het geheugen en leest meer uit de database. Sommige pagina’s doen er even langer over, en achtergrondwerk zoals het kopiëren van de muziekcatalogus draait minder vaak.

Instelling	Effect
(standaard, Linux)	Gaat vanzelf aan bij ongeveer 2,5 GiB geheugen of minder.
HOLYARRS_LOW_MEMORY=1	Altijd aan.
HOLYARRS_LOW_MEMORY=0	Altijd uit.

De eerste logregel zegt of de modus aan staat en waarom.

Scopes van API-sleutels

Maak een sleutel in Settings > API > API keys en stuur hem mee in de header X-Api-Key.

Scope	Bereikt
read	Bibliotheek, taken, downloads, geschiedenis, gezondheid, instellingen. Geheimen gemaskeerd.
health_read	Alleen gezondheidsstatussen. Voor monitoringtools.
write	Elke wijziging behalve admin-routes en knoppen.
admin	Mensen, uitnodigingen, aanvraaglimieten, API-sleutels, wachtwoord en tweestapsverificatie, aanmeldinstellingen, backups.
control	De knoppen op deze pagina. Alleen de eigenaar en beheerders kunnen die geven.
all	read, write en admin. Niet control.

Een sleutel kan nooit meer doen dan de persoon die hem heeft gemaakt. Scopes kun je later niet wijzigen; maak een nieuwe sleutel. Elke route met zijn scope: /api/v1/openapi.json.

Gerelateerde pagina’s

• Gezondheidscontroles
• Backups
• API-routes