Marinara sichern und wiederherstellen

Speichere eine Kopie deiner Daten aus Marinara Engine, damit du sie später wiederherstellen kannst. Tu das vor einem Update, einem Gerätewechsel oder bevor du deine Daten löschst.

Welche Option passt?

Option	Ergebnis	Zweck
Download Backup	Eine `.zip` mit allen Daten und Dateien.	Eine vollständige Kopie von allem.
Export Profile	Eine kleinere Datei mit deinen Kontodaten (Charaktere, Chats, Lorebooks und mehr).	Eine Kopie ohne geheime Werte oder Dateien für andere Tools.

Eine .zip ist eine Datei, die viele Dateien enthält. Beide Optionen findest du unter Settings → Advanced → Backup & Export. Die Wiederherstellung findest du unter Settings → Imports → Profile & Marinara.

Bevor du anfängst: Auf dem Rechner, auf dem Marinara läuft, funktionieren diese Funktionen sofort. Von einem Handy, Tablet oder anderen Gerät aus musst du das Admin-Secret auf dem Server festlegen und denselben Wert unter Settings → Advanced → Admin Access eingeben. Das Admin-Secret ist ein Passwort in der .env-Datei des Servers, unter ADMIN_SECRET. Siehe den Abschnitt „Privileged APIs (ADMIN_SECRET)“ in der Referenz zur Server-Konfiguration und Fernzugriff.

Download Backup

Öffne Settings → Advanced.
Klick unter Backup & Export auf Download Backup. Die Schaltfläche zeigt Creating backup….
Speichere die Datei, wenn dein Browser danach fragt, oder suche sie im Downloads-Ordner.

Die .zip enthält:

deine gespeicherten Textdaten (Charaktere, Chats, Lorebooks, Presets, Verbindungen, Einstellungen);
deine hochgeladenen und erzeugten Dateien, etwa Avatare, Sprites, Hintergründe, Galeriebilder, Schriften, eigene Emojis und Sticker sowie deinen eigenen Benachrichtigungston;
die Datei .encryption-key, sofern vorhanden;
eine Anleitung RESTORE.txt zur Wiederherstellung von Hand (siehe Von Hand wiederherstellen).

Die Ordnernamen stehen unter Wo Marinara deine Daten speichert.

Warnung: Ein Backup enthält deine gespeicherten API-Keys und die Datei .encryption-key, mit der sie entschlüsselt werden können. Gib es niemals weiter. Bewahre es an einem privaten Ort auf.

Unter Android kannst du den Datenordner der App nicht öffnen. Mit Download Backup bekommst du eine Kopie vom Gerät.

Wenn es nicht funktioniert: Erscheint „Backup preparation timed out after one hour.“, versuche es erneut. Kann ein anderes Gerät das Backup nicht herunterladen, prüf Admin Access (siehe oben).

Automatische Backups

Marinara kann auf dem Rechner, auf dem es läuft, regelmäßig ein vollständiges Backup anlegen.

Öffne Settings → Advanced → Backup & Export.
Aktiviere Automatic backups.
Wähle Daily, Weekly oder Monthly.
Stell Automatic backups kept auf einen Wert von 1 bis 9999.

Marinara erstellt das erste Backup kurz nach dem Aktivieren. Nach jedem Durchlauf behält es die festgelegte Anzahl der neuesten Backups und löscht ältere automatische Backups. Backups, die du mit Download Backup erstellt hast, löscht es nie.

Automatische Backups liegen im Ordner backups/ innerhalb des Datenordners. Das neueste heißt marinara-automatic-backup.zip. Ältere Dateien tragen Datum und Uhrzeit im Namen. Sie verwenden dasselbe Format wie Download Backup.

Für jeden Durchlauf muss Platz für ein weiteres vollständiges Archiv frei sein, da das alte bestehen bleibt, bis das neue fertig ist. Reicht der Platz nicht aus, überspringt Marinara den Durchlauf und zeigt den Grund neben der Einstellung an. Sobald wieder Platz frei ist, versucht Marinara es erneut.

Tipp: Bewahre eine zweite Kopie außerhalb des Datenordners auf. Bei einem Festplattenausfall oder wenn die App gelöscht wird, gehen auch die automatischen Backups verloren.

Ein Profil exportieren

Öffne Settings → Advanced → Backup & Export.
Klick auf Export Profile. Ein Dialog mit demselben Titel öffnet sich.
Wähle ein Format.
Dein Browser lädt die Datei herunter.

Marinara Native behält Charaktere, Personas, Chats, Lorebooks, Presets, Agenten, Themes, den Code von Personal Extensions und Medien. API-Keys, Webhook-Links und manche Chat-Einstellungen werden nicht wiederhergestellt (siehe Keys erneut eingeben). Du kannst das Profil in Marinara wiederherstellen.
Compatible JSON erstellt eine .zip mit einfachen Charakter-, Persona- und Lorebook-Dateien für andere Tools. Du kannst sie nicht in Marinara wiederherstellen.

Ein natives Profil wird als marinara-profile.json heruntergeladen. Ist es zu groß, bietet Marinara stattdessen eine ZIP-Datei an. Klick auf Export ZIP, um marinara-profile.zip herunterzuladen.

Ein natives Profil behält den Code von Personal Extensions, aber nicht den Aktivierungs- oder Freigabestatus. Jede wiederhergestellte Erweiterung ist deaktiviert. Prüfe sie erneut unter Settings → Addons.

Mit Import Profile wiederherstellen

Import Profile lädt eine Profildatei oder eine .zip von Download Backup.

Öffne Settings → Imports.
Klick unter Profile & Marinara auf Import Profile (JSON/ZIP).
Wähle marinara-profile.json, marinara-profile.zip oder eine Backup-.zip. Die Schaltfläche zeigt Scanning Profile....
Lies den Dialog Import Profile. Er listet die gefundenen Daten auf und warnt, dass du den Import nicht rückgängig machen kannst.
Klick auf Import oder zum Abbrechen auf Cancel. Die Schaltfläche zeigt Importing Profile..., danach folgt ein Fortschrittsbalken. Nach Abschluss bestätigt eine Meldung den Import.

Wenn es nicht funktioniert:

Außer unter localhost, 127.0.0.1 oder [::1] ist für den Profilimport HTTPS erforderlich. Die Fehlermeldung lautet „Profile import requires HTTPS outside local development.“ Öffne Marinara über eine HTTPS-Adresse.
Fehlen Mediendateien in einer .zip, wird der Import trotzdem abgeschlossen. Eine Warnung listet die fehlenden Dateien auf; den Rest importiert Marinara.

Importierst du dasselbe Profil zweimal, aktualisiert Marinara die vorhandenen Elemente, statt Kopien anzulegen. Profile aus sehr alten Versionen können Duplikate erzeugen.

Keys erneut eingeben

Import Profile stellt API-Keys und Webhook-Links nie wieder her, auch nicht aus einer .zip von Download Backup. Ein API-Key ist ein geheimer Code, den du von einem Dienst bekommst. In der Profildatei und im Profil innerhalb eines Backups sind diese Werte entfernt. Nach dem Import auf einem neuen Rechner musst du sie erneut eingeben:

Öffne Connections über die obere Leiste.
Öffne jedes Konto, das du nutzt, gib den API-Key ein und speichere. Siehe Verbindung zu einem KI-Anbieter herstellen.
Gib den Webhook-Link bei jedem eigenen Tool, das ihn verwendet, erneut ein.

Auch manche Chat-Einstellungen mit Adressen oder Keys (Discord, DeepL, Intiface) bleiben leer. Gib sie in den Chat Settings jedes betroffenen Chats erneut ein.

Beim Import werden bereits gesetzte Keys derselben Installation nicht gelöscht.

Auf einen neuen Rechner umziehen

Installiere Marinara auf dem neuen Rechner und starte es. Siehe Installation.
Öffne Settings → Imports → Profile & Marinara und klick auf Import Profile (JSON/ZIP).
Wähle deine .zip von Download Backup oder deine Profildatei und klick auf Import.
Gib deine API-Keys erneut ein, wie oben beschrieben.

Die Schlüsseldatei im Backup hilft nur, wenn du den gesamten Datenordner von Hand kopierst, wie unten beschrieben.

Von Hand wiederherstellen

Nutze diesen Weg nur, wenn Import Profile nicht verfügbar ist. Die .zip enthält einen Ordner, beispielsweise marinara-backup-..., mit einer Anleitung RESTORE.txt.

Stoppe Marinara.
Entpacke das Backup.
Kopiere die Ordner und die Datei .encryption-key aus dem entpackten Ordner in deinen Datenordner. Siehe Wo Marinara deine Daten speichert.
Starte Marinara.

Bewahre die Datei .encryption-key zusammen mit dem Ordner storage auf. Sonst können die gespeicherten API-Keys nicht gelesen werden.

Die Liste Existing backups unter Backup & Export ist normalerweise leer. Du brauchst sie nicht.