Bereiche und abgesicherter Modus

Einrichtung

Schalte die Bereiche aus, die du nicht nutzt, starte im abgesicherten Modus, wenn etwas kaputt ist, und starte HolyArrs aus dem Browser neu.

Einen Bereich ein- oder ausschalten

HolyArrs hat 5 Bereiche: Movies (Filme), TV shows (Serien), Music (Musik), Subtitles (Untertitel) und Requests (Anfragen). Du wählst sie zuerst im Assistenten für den ersten Start.

Öffne Settings > Parts (Einstellungen > Bereiche).
Klicke neben einem Bereich auf Turn on (Einschalten) oder Turn off (Ausschalten). Du solltest sehen, wie seine Menüpunkte erscheinen oder verschwinden.

Nichts wird gelöscht. Schalte einen Bereich wieder ein, und er macht dort weiter, wo er aufgehört hat.

Im abgesicherten Modus starten

Der abgesicherte Modus startet nur das Nötigste. Er ist für den Fall gedacht, dass etwas HolyArrs am Starten oder Arbeiten hindert. Du kannst dich anmelden, deine Bibliothek ansehen, Einstellungen ändern und ein Backup erstellen oder wiederherstellen. Suchen, Hinzufügen, Aktualisieren, Herunterladen und Importieren warten bis zum nächsten normalen Start.

Öffne Settings > Danger zone (Einstellungen > Gefahrenzone).
Klicke auf Restart in safe mode (Im abgesicherten Modus neu starten). Du solltest auf jeder Seite ein Banner sehen.
Behebe das Problem und klicke dann auf Restart HolyArrs (HolyArrs neu starten). Der nächste Start ist normal.

Wenn du die Seite nicht erreichst, setze HOLYARRS_SAFE_MODE=1 in Compose oder starte mit -safe-mode. Entferne es nach der Behebung wieder: Mit beidem läuft jeder Start im abgesicherten Modus.

Optionen

Was stoppt, wenn ein Bereich aus ist

Bereich	Stoppt	Läuft weiter
Filme	Filmseiten und Menüpunkte, Hinzufügen, Suchen, Aktualisieren	Downloads, die schon in deinem Downloader sind, werden weiter verfolgt. Dateien bleiben.
Serien	Serienseiten, Hinzufügen, Suchen, Staffelsuchen, Aktualisierungen	Wie bei Filme.
Musik	Künstler- und Albumseiten, Musikeinstellungen, Aktualisierungen von Künstlern, Albumsuchen	Wie bei Filme.
Untertitel	Untertitel-Einstellungen, die Seite für fehlende Untertitel, Suchen und Prüfungen	Untertiteldateien neben deinen Videos bleiben.
Anfragen	Anfrageseiten und das Anfragen von Titeln	Bestehende Anfragen bleiben und kommen zurück, wenn der Bereich wieder an ist.

Immer an: Anmeldung und Konten, Bibliotheksordner, Quellen, Downloader und Downloads, Benachrichtigungen, Verlauf, Backups, Zustandsprüfungen, Einstellungen und die API.

Untertitel brauchen Filme oder Serien. Anfragen brauchen Filme, Serien oder Musik. HolyArrs lehnt eine Änderung ab, die das verletzt, und sagt dir, was du zuerst ändern musst.
Eine eingereihte Aufgabe für einen ausgeschalteten Bereich wartet und läuft, sobald der Bereich an ist.
Einen Bereich auszuschalten spart keinen Arbeitsspeicher. Alles läuft in einem einzigen Programm.

Neu starten, pausieren und herunterfahren

Settings > Danger zone (Besitzer und Admins) hat Restart HolyArrs, Restart in safe mode und Shut down (Herunterfahren), dazu Pause (Pausieren), Resume (Fortsetzen) und Restart (Neu starten) für jede Hintergrundaufgabe, etwa Backups oder die Synchronisierung der Downloads.

Bedienelemente, die etwas stoppen, musst du innerhalb von 60 s bestätigen.
Jedes benutzte Bedienelement wird mit deinem Namen in den Verlauf geschrieben.
Du brauchst eine Anmeldung mit Passwort. Eine Anmeldung ohne Passwort in deinem lokalen Netzwerk wird abgelehnt.

Ein Neustart stoppt HolyArrs sauber und lässt Docker es wieder starten. Setze deshalb restart: unless-stopped.

Neustart-Richtlinie	Neustart	Herunterfahren
`unless-stopped` oder `always`	Kommt zurück	Kommt auch zurück
`on-failure`	Kommt zurück	Bleibt aus
`no`	Bleibt aus	Bleibt aus

Wenn es nicht funktioniert

Symptom	Ursache	Lösung
HolyArrs kann einen Bereich nicht ausschalten	Ein anderer Bereich braucht ihn	Schalte zuerst diesen Bereich aus, wie es die Meldung sagt.
Der Neustart hat HolyArrs dauerhaft heruntergefahren	Die Neustart-Richtlinie ist `no`	Starte den Container und setze `restart: unless-stopped`.
Bedienelemente werden abgelehnt	Lokale Anmeldung ohne Passwort, oder dem Schlüssel fehlt `control`	Melde dich mit deinem Passwort an.
Eine Aufgabe bleibt fehlgeschlagen	Sie braucht dich	Lies den Grund unter `/health`, behebe ihn und klicke bei dieser Aufgabe auf Restart.

Mehr Lösungen: Fehlerbehebung.

Für Fortgeschrittene

Zustände

/health, Settings > Parts und GET /api/v1/health/states listen jede Hintergrundaufgabe, jeden Bereich und jede verknüpfte App mit einem Zustand und einem Grund auf.

Zustand	Bedeutung
off	Ausgeschaltet, pausiert oder im abgesicherten Modus nicht gestartet.
starting	Startet gerade oder ist noch nicht geprüft.
running	Funktioniert.
retrying	Fehlgeschlagen; HolyArrs versucht es erneut und wartet jedes Mal länger.
failed	Abgestürzt, hängt fest oder braucht dich. Der Grund sagt, was zu tun ist.

Eine abgestürzte Aufgabe zeigt erst failed, dann retrying und startet dann wieder. Anmeldung, Bibliothek und Backups funktionieren in der Zwischenzeit weiter. Eine festhängende Aufgabe löst sich bei einem vollständigen Neustart.

Arbeitsspeicher und Modus für wenig Arbeitsspeicher

HolyArrs versucht, unter 384 MiB zu bleiben. Das passt in ein Container-Limit von 500 MB. Für ein eigenes Ziel setzt du GOMEMLIMIT auf etwa 80 Prozent des Arbeitsspeichers des Containers.

Der Modus für wenig Arbeitsspeicher hält weniger im Arbeitsspeicher und liest mehr aus der Datenbank. Manche Seiten brauchen einen Moment länger, und Hintergrundarbeit wie die Kopie des Musikkatalogs läuft seltener.

Einstellung	Wirkung
(Standard, Linux)	Schaltet sich bei etwa 2.5 GiB Arbeitsspeicher oder weniger von selbst ein.
`HOLYARRS_LOW_MEMORY=1`	Immer an.
`HOLYARRS_LOW_MEMORY=0`	Immer aus.

Die erste Log-Zeile sagt, ob er an ist und warum.

Scopes von API-Schlüsseln

Erstelle einen Schlüssel unter Settings > API > API keys (Einstellungen > API > API-Schlüssel) und sende ihn im Header X-Api-Key.

Scope	Reicht für
`read`	Bibliothek, Aufgaben, Downloads, Verlauf, Zustand, Einstellungen. Geheimnisse sind maskiert.
`health_read`	Nur Zustände. Für Monitoring-Tools.
`write`	Jede Änderung außer Admin-Routen und Bedienelementen.
`admin`	Personen, Einladungen, Anfragelimits, API-Schlüssel, Passwort und Zwei-Faktor, Anmeldeeinstellungen, Backups.
`control`	Die Bedienelemente auf dieser Seite. Nur der Besitzer und die Admins können ihn vergeben.
`all`	`read`, `write` und `admin`. Nicht `control`.

Ein Schlüssel kann nie mehr als die Person, die ihn erstellt hat. Scopes lassen sich später nicht ändern; erstelle einen neuen Schlüssel. Jede Route mit ihrem Scope: /api/v1/openapi.json.