Updates

Neu hier

HolyArrs sagt dir, wenn eine neue Version da ist, und installiert sie nie selbst. Du ziehst das neue Image, wann es dir passt.

Prüfen, ob eine neue Version da ist

Öffne die Seite Status (http://your-server:6262/health).
Lies Updates. Du solltest eine dieser Meldungen sehen:

Meldung	Bedeutung
„HolyArrs 1.2.0 is out, newer than this one.“ (HolyArrs 1.2.0 ist da, neuer als diese Version.)	Aktualisiere, wenn du so weit bist
„This is the newest version.“ (Das ist die neueste Version.)	Nichts zu tun
„No HolyArrs release is published yet.“ (Es ist noch keine HolyArrs-Version veröffentlicht.)	Der Feed ist leer. Es ist kein Fehler
„The last check did not work: …“ (Die letzte Prüfung hat nicht funktioniert: …)	Feed nicht erreicht, oft fehlt das Internet
„The update check is off: …“ (Die Update-Prüfung ist aus: …)	In den Einstellungen ausgeschaltet

Um sofort nachzufragen, klicke auf Check now (jetzt prüfen) oder Check again (erneut prüfen). Dafür brauchst du die Berechtigung Change settings (Einstellungen ändern).

Eine neuere Version erscheint auch als Warnung in den Zustandsprüfungen. Eine fehlgeschlagene Prüfung steht nur unter Updates.

Aktualisieren

Zieh das neue Image und starte neu: docker compose pull, dann docker compose up -d.
HolyArrs startet. Wenn die neue Version ändert, wie Daten gespeichert werden, erstellt HolyArrs zuerst ein Backup und aktualisiert dann die Daten. Du solltest sehen, wie sich die App mit der neuen Version öffnet.

Zur vorherigen Version zurückkehren

HolyArrs kann sein eigenes Image nicht ändern. Du startest also das ältere Image, und HolyArrs spielt die älteren Daten zurück.

Ändere den Image-Tag in deiner Compose-Datei (oder in docker run) auf den älteren, zum Beispiel holyarrs/holyarrs:<older version>.
Führe docker compose up -d aus.
Wenn das Update die Daten nicht geändert hat, startet die ältere Version. Du bist fertig.
Sonst zeigt die ältere Version eine Seite statt der App. Klicke auf Put back the data from before the update (die Daten von vor dem Update zurückspielen).
Gib den Einmalcode ein. Du findest ihn mit docker logs <container>; suche nach „one-time code“.
HolyArrs prüft das Backup, spielt es zurück und stoppt. Du solltest sehen, wie der Container über seine Neustart-Richtlinie mit diesen Daten wieder startet. Ohne Neustart-Richtlinie startest du ihn selbst.

Ohne die Seite: docker exec <container> /holyarrs restore --pre-update, dann docker restart <container>. Ohne Docker: Stoppe HolyArrs, führe holyarrs restore --pre-update aus und starte es wieder.

Nichts wird gelöscht. Die neueren Daten wandern nach backups/before-restore-<time>/, du kannst den Schritt also rückgängig machen. Wenn du mehr als eine Version zurückgehst, nimmt HolyArrs das neueste Backup von vor einem Update, das diese Version lesen kann.

Optionen

Alle stehen unter Settings > Health checks (Einstellungen > Zustandsprüfungen). Die letzten drei liegen im erweiterten Teil der Karte.

Einstellung	Standard	Ändere sie, wenn
Check for a newer HolyArrs (nach einer neueren HolyArrs-Version suchen)	An	Du willst gar keine Anfrage nach außen
Check for updates every (Abstand der Update-Prüfung)	Tag	Du willst seltener prüfen: alle 3, 7, 14 oder 30 Tage
Release feed (Release-Feed)	Leer (HolyArrs-Versionen)	Du betreibst deinen eigenen Feed
Feed may be on the local network (Feed darf im lokalen Netzwerk liegen)	Aus	Dein Feed liegt in deinem eigenen Netzwerk
Include test versions (like 1.2.0-rc1) (Testversionen wie 1.2.0-rc1 einbeziehen)	Aus	Du willst Hinweise auf Testversionen

Wenn es nicht funktioniert

Symptom: „The last check did not work.“ Ursache: Der Server hat kein Internet, oder dein eigener Feed liegt im lokalen Netzwerk. Lösung: Prüfe den Internetzugang oder schalte Feed may be on the local network ein.

Symptom: Der Release-Feed lässt sich nicht speichern. Ursache: Die Adresse enthält einen Namen, ein Passwort, ?query oder #fragment, oder sie beginnt nicht mit http:// oder https://. Lösung: Entferne diese Teile.

Symptom: Das Update hat angehalten, weil der Speicherplatz nicht reicht. Ursache: Kein Platz für die Kopie und das Update. Lösung: Schaffe freien Speicherplatz dort, wo der Konfigurationsordner liegt, und starte dann erneut.

Symptom: Die Seite zum Zurückkehren lehnt deinen Code ab. Ursache: Ein alter Code, oder 10 falsche Codes seit dem letzten Start. Lösung: Kopiere den Code aus der neuesten Log-Zeile. Nach 10 falschen Versuchen starte den Container neu und nimm den neuen Code.

Zurückgestellte Funktionen

Einige Funktionen sind in dieser Version standardmäßig aus. Du schaltest sie auf eigenes Risiko ein. Solange sie zurückgestellt sind, sind ihre Seiten und Menüpunkte ausgeblendet, ihre API-Routen antworten mit „not found“, und ihre Aufgaben laufen nicht. Daten, die du für sie gespeichert hast, bleiben erhalten.

Um eine einzuschalten, füge ihren Schalter zu HOLYARRS_FLAGS hinzu, durch Kommas getrennt, und starte den Container neu:

environment:
  HOLYARRS_FLAGS: "subtitle_sites,alert_channels_more"

Entferne den Namen und starte neu, um sie auszuschalten. Ausgeblendete Einstellungen kommen zurück, wenn du sie wieder einschaltest.

Schalter	Funktion
`plex_watchlists`	Plex-Merklisten werden zu Anfragen
`row_title_stats`	Statistiken zu den Zeilentiteln von Entdecken unter Appearance (Darstellung)
`trakt_lists`	Trakt-Schlüssel, Trakt-Listen und Trakt-Rezensionen. TMDB-Listen bleiben an
`alert_channels_more`	Benachrichtigungen über Telegram, ntfy, Gotify, Pushover und Webhook. Discord und E-Mail bleiben an
`subtitle_sites`	Untertitel-Seiten und Untertitelsuche. Deine Untertitelsprache bleibt an
`emby_signin`	Mit Emby anmelden. Das Aktualisieren der Emby-Bibliothek funktioniert weiterhin
`go_back`	Das Feld Go back (zurückkehren) auf der Statusseite. Die Schritte unter Zurückkehren funktionieren auch ohne

Nach dem Hinzufügen eines Schalters hat sich nichts geändert? Prüfe die Schreibweise (Kleinbuchstaben, Unterstriche) und starte den Container neu, nicht nur die Seite.

Für Fortgeschrittene

Was die Prüfung sendet

Eine Anfrage an api.github.com nach der neuesten Version, nur mit User-Agent: HolyArrs/<version>. Kein Konto, kein Schlüssel, keine Medienliste. Ist die Prüfung aus, gibt es gar keine Anfrage.

Die letzte Antwort wird gespeichert, ein Neustart prüft also nicht, bevor es fällig ist. Eine Prüfung wartet höchstens 15 s, liest höchstens 512 KB und folgt höchstens 3 Weiterleitungen, ohne je zwischen http und https zu wechseln. Ein Link zu den Versionshinweisen erscheint nur, wenn er auf die Versionsseiten von HolyArrs auf GitHub zeigt; sonst steht die Version als reiner Text da.

Release feed nimmt eine Release-Antwort im GitHub-Stil an, eine Liste von Releases, beliebiges JSON mit version oder reinen Text, der die Version enthält. Adressen für Cloud-Metadaten werden immer abgelehnt. Eine Testversion gilt als älter als die normale Version.

Das Backup vor einem Update

Bevor HolyArrs gespeicherte Daten ändert, macht es Folgendes:

Es prüft, ob Platz für eine Kopie und das Update ist. Wenn nicht, ändert sich nichts. Überspringen mit HOLYARRS_SKIP_SPACE_CHECK=yes.
Es kopiert jede Datenbank nach backups, prüft die Kopie und schreibt eine sha256-Datei daneben. Nach 3 fehlgeschlagenen Kopien ändert sich nichts.
Es führt jeden Update-Schritt einzeln aus und prüft ihn. Ein fehlgeschlagener Schritt wird rückgängig gemacht; fertige Schritte bleiben. Starte dieselbe Version noch einmal, um ab dem fehlgeschlagenen Schritt mit derselben Kopie weiterzumachen.

Nach dem ersten guten Start wird aus der Kopie holyarrs-backup-pre-update-<time>.zip, beschrieben wie „before updating from 1.1.0 to 1.2.0“. Sie erscheint unter Settings > Backups und in holyarrs restore --list. Die neuesten 3 bleiben erhalten; der Backup-Zeitplan entfernt sie nie. Eine frische Installation oder ein Update, das die Daten nicht anfasst, erstellt keins.