Backups

Bewahre eine Kopie deiner Einrichtung auf. Du kannst sie nach einem missglückten Update, einem defekten Datenträger oder einem Umzug auf einen neuen Rechner zurückspielen.

Bevor du beginnst

• Settings > Backups (Einstellungen > Backups) braucht die Berechtigung Change settings (Einstellungen ändern). Nur der Besitzer stellt wieder her.
• Für Herunterladen, Löschen und Wiederherstellen brauchst du eine Anmeldung mit Passwort aus den letzten Minuten.

Ein Backup erstellen

1. Öffne Settings > Backups.
2. Klicke auf Back up now (Jetzt Backup erstellen). Du solltest das neue Backup unter Saved backups (Gespeicherte Backups) sehen.
3. Klicke daneben auf Download (Herunterladen), um eine Kopie außerhalb des Servers aufzubewahren.

Den Hauptschlüssel sichern

Backups enthalten nie den Hauptschlüssel. Er öffnet die Passwörter und API-Schlüssel in deinen Einstellungen. Ohne den passenden Schlüssel kann ein wiederhergestelltes Backup sie nicht lesen.

1. Unter Master key (Hauptschlüssel) klickt der Besitzer auf Download key kit (Schlüssel-Kit herunterladen).
2. Bewahre die Datei nicht auf dem Server und getrennt von deinen Backups auf. Die Warnung zum Schlüssel-Kit sollte aus Settings > Backups und aus den Zustandsprüfungen verschwinden.

Wenn du die Datei später brauchst, benenne sie in holyarrs.key um und lege sie in den Konfigurationsordner. Du bist nicht der Besitzer? Bitte den Besitzer, sie herunterzuladen.

Ein Backup wiederherstellen

Gefahr

Änderungen seit dem Backup gehen verloren. Halte vorher den passenden Hauptschlüssel bereit.

1. Klicke auf Restore from a file (Aus einer Datei wiederherstellen) und wähle ein Backup-Zip von HolyArrs.
2. Bestätige.
3. HolyArrs prüft die Datei. Du solltest Restore ready. It applies on the next start. (Wiederherstellung bereit. Sie wird beim nächsten Start angewendet.) sehen.
4. HolyArrs startet neu und spielt das Backup ein. Mit der empfohlenen Neustart-Richtlinie von Docker passiert das von selbst.

Deine aktuellen Datenbanken wandern nach /config/backups/before-restore-<time>. So kannst du eine Wiederherstellung rückgängig machen.

Optionen

Wie oft

Option	Erstellt ein Backup	Behält
Balanced (ausgewogen, Standard)	Jeden Tag	Die letzten 7 Tage und 4 Wochenkopien
Light (sparsam)	Einmal pro Woche	4 Wochen. Braucht am wenigsten Platz
Careful (vorsichtig)	Jeden Tag	Jede Kopie für 30 Tage

Das neueste geplante Backup bleibt immer erhalten. Diese Regeln räumen nur geplante Backups auf. Backups, die du selbst erstellst, bleiben, bis du sie löschst (Papierkorb-Schaltfläche in der Zeile; das lässt sich nicht rückgängig machen). HolyArrs erstellt außerdem ein Backup vor jedem Update, das gespeicherte Daten ändert, und behält die neuesten 3; siehe Updates.

Auf einen neuen Rechner umziehen

Eine neue Installation erzeugt beim ersten Start ihren eigenen Hauptschlüssel. Dieser Schlüssel kann deine alten Backups nicht öffnen, also wird die Wiederherstellung abgelehnt. Lege zuerst den alten Schlüssel an seinen Platz. In den Beispielen heißt der Container holyarrs; nimm deinen eigenen Namen.

1. Erstelle vor dem ersten Start den Container, ohne ihn zu starten: docker compose create, oder deine docker run-Zeile mit docker create anstelle von docker run -d.
2. Kopiere deinen alten Schlüssel hinein: docker cp holyarrs.key holyarrs:/config/. Ein Schlüssel-Kit, das du in holyarrs.key umbenannt hast, geht auch. Das funktioniert mit einem benannten Volume und mit einem Ordner auf dem Host; HolyArrs übergibt die Dateien in /config beim Start an deine PUID und PGID. Wenn du HOLYARRS_MASTER_KEY_FILE nutzt, lege den Schlüssel stattdessen an diesen Pfad auf dem Host, lesbar für deine PUID und PGID.
3. Stelle das Backup wieder her. Wähle einen Weg:

   • Starte HolyArrs, schließe den ersten Start ab und nutze dann Restore from a file in Settings > Backups.

   • Oder stelle vor dem ersten Start wieder her. Lege das Zip mit unverändertem Namen in einen Ordner namens backups und kopiere ihn mit docker cp backups holyarrs:/config/ hinein. Führe dann die Wiederherstellung einmal mit demselben Image aus:

     • Compose: docker compose run --rm holyarrs restore <zip name>
     • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>

     Bei einem Pfad zur Schlüsseldatei füge -e HOLYARRS_MASTER_KEY_FILE=<its path> hinzu, damit die Wiederherstellung gegen deinen Schlüssel prüft. restore --list zeigt die Backup-Namen, die es sehen kann.

4. Starte HolyArrs. Du solltest deine Bibliothek und deine Einstellungen wieder sehen.

Du hast die neue Installation gestartet, bevor du den Schlüssel kopiert hast? Wenn darauf nichts ist, was du behalten willst, stoppe HolyArrs, kopiere deinen alten Schlüssel mit demselben docker cp über den neuen, stelle wieder her und starte dann.

Wenn es nicht funktioniert

Symptom: „Backups are off in this build“ (Backups sind in diesem Build ausgeschaltet). Ursache: Diese Kopie läuft ohne ihre Backup-Verwaltung. Lösung: In der App gibt es keine; die Bedienelemente für Backups fehlen.

Symptom: Herunterladen, Löschen oder Wiederherstellen fragt nach deinem Passwort. Ursache: Dafür brauchst du eine frische Anmeldung mit Passwort. Lösung: Melde dich erneut mit deinem Passwort an und versuche es noch einmal.

Symptom: Die Wiederherstellung wird wegen des Hauptschlüssels abgelehnt. Ursache: Der Schlüssel im Konfigurationsordner passt nicht zum Backup. Lösung: Lege die passende holyarrs.key zurück und versuche es erneut.

Die Wiederherstellung lehnt auch ein Zip ab, das zu groß oder beschädigt ist, unerwartete Dateien enthält, aus einer neueren Datenbankversion stammt oder Daten enthält, die dein Schlüssel nicht lesen kann.

Für Fortgeschrittene

Was in einem Backup steckt

Jedes Backup ist ein Zip mit der Hauptdatenbank, der Ereignis-Datenbank, falls es eine gibt, und backup.json (HolyArrs-Version, Datenbankversionen, Art des Backups, Zeitpunkt der Erstellung). Medien, Downloads, Bilder, Logs und der Hauptschlüssel sind nicht darin.

Vor dem ersten Start wiederherstellen

docker cp funktioniert mit einem benannten Volume und mit einem Ordner auf dem Host; HolyArrs übergibt die Dateien in /config beim Start an deine PUID und PGID. Mit HOLYARRS_MASTER_KEY_FILE legst du den Schlüssel stattdessen an diesen Pfad auf dem Host, lesbar für PUID und PGID.

1. Lege das Zip mit unverändertem Namen in einen Ordner namens backups und kopiere ihn hinein: docker cp backups holyarrs:/config/.
2. Führe die Wiederherstellung einmal mit demselben Image aus:
   • Compose: docker compose run --rm holyarrs restore <zip name>
   • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>
3. Bei einem Pfad zur Schlüsseldatei füge -e HOLYARRS_MASTER_KEY_FILE=<its path> hinzu, damit die Wiederherstellung gegen deinen Schlüssel prüft.
4. Starte HolyArrs.

restore --list zeigt die Backup-Namen, die es sehen kann.

Verwandte Seiten

• Updates
• Installieren
• Zustandsprüfungen