Marinara Engine aktualisieren

Bring Marinara Engine auf eine neuere Version, such in der App nach Updates und geh zurück, wenn etwas kaputtgeht. Chats und Einstellungen bleiben bei einem Update erhalten.

Welcher Update-Weg passt zu mir?

So hast du installiertSo aktualisierst du
Windows-Installer oder start.batSchließ Marinara und öffne es wieder. Siehe Windows.
macOS oder LinuxFühr ./start.sh erneut aus. Siehe macOS und Linux.
Docker oder PodmanHol das neue Image und starte neu. Siehe Docker oder Podman.
Android-AppAktualisiere die APK und tipp dann auf Install / Start Marinara. Siehe Android (Termux).
iPhone oder iPadAktualisiere das Gerät, auf dem der Server läuft. Siehe iPhone und iPad.

Vorher ein Backup anlegen

Leg vor jedem großen Versionssprung ein Backup an, und immer dann, wenn du vielleicht zu einer älteren Version zurückkehren willst.

  1. Öffne Settings (Einstellungen).
  2. Wechsle zum Tab Advanced (Erweitert).
  3. Such den Abschnitt Backup & Export.
  4. Klick auf Download Backup (Backup herunterladen).
  5. Speichere die .zip-Datei an einem sicheren Ort.

Während der Arbeit zeigt die Schaltfläche Creating backup…. Danach speichert dein Browser eine .zip mit deinen Daten. Wie du sie wiederherstellst, steht unter Marinara sichern und wiederherstellen.

Update nach Plattform

Wähl den Abschnitt, der zu deiner Installation passt. Eine Git-Kopie ist eine Kopie, die mit dem Werkzeug Git installiert wurde. Dazu zählen der Windows-Installer und jeder git clone.

Windows

Der Launcher aktualisiert Marinara, wenn du es startest.

  1. Beende Marinara Engine.
  2. Öffne es erneut über die Verknüpfung auf dem Desktop oder im Startmenü, oder führ start.bat aus.

Der Launcher holt den neuesten Code, installiert Geändertes neu, baut die App neu und startet die neue Version. Hast du den Code selbst geändert, legt er deine Änderungen beiseite und holt sie nach dem Update zurück. Gelingt das nicht, behält er deine aktuelle Version und gibt einen Hinweis aus. Vor dem Update kopiert er deine Daten, und er überspringt ein Update, das auf einer Version landen würde, die älter ist als deine Daten (siehe Downgrade auf eine ältere Version).

Um das Update einmal zu überspringen, führ start.bat --skip-update aus. Soll deine installierte Version über mehrere Starts hinweg bleiben, setz AUTO_UPDATE_ENABLED=false in der .env des Projekts. Das schaltet nur die automatischen Updates ab. Manuelle Befehle und Settings → Advanced → Check for Updates funktionieren weiterhin.

Meldet der Launcher, dass Node.js zu alt ist, installier Node.js 24 LTS (Long Term Support, die empfohlene stabile Ausgabe) und starte Marinara danach erneut. Du kannst auch den neuesten Installer von der GitHub-Releases-Seite herunterladen und ausführen.

macOS und Linux

  1. Beende Marinara Engine.
  2. Starte den Launcher aus deinem Marinara-Ordner.
./start.sh

Der Launcher holt den neuesten Code, installiert geänderte Abhängigkeiten neu, baut die App neu und startet die neue Version. Mit ./start.sh --skip-update überspringst du das Update einmal, mit AUTO_UPDATE_ENABLED=false in der .env schaltest du automatische Updates ab. Ist Node.js zu alt, installier Node.js 24 LTS und starte den Launcher erneut.

Docker oder Podman

Container werden über ein neues Image aktualisiert, nicht über den Launcher. Leg ein Backup an und führ dann diesen Befehl in dem Ordner aus, in dem deine Compose-Datei liegt.

docker compose pull && docker compose up -d

Mit Podman nimmst du stattdessen podman compose. Release-Images erscheinen als ghcr.io/pasta-devs/marinara-engine:X.Y.Z und :latest, dazu die passenden -lite-Tags. Ein Pull lässt deine Daten im Volume marinara-data unberührt. Siehe Installation im Container.

Android (Termux)

Termux ist die Android-App, die ein kleines Linux-System für Marinara ausführt. Der Launcher darin aktualisiert Marinara bei jedem Start.

  1. Öffne Termux.
  2. Starte den Launcher.
cd Marinara-Engine
./start-termux.sh

Der Launcher aktualisiert den Code, hebt Node.js bei Bedarf an, baut die App neu und startet den Server. Macht ein Update etwas kaputt und willst du auf deiner aktuellen Kopie bleiben, häng --skip-update an. Um automatische Updates abzuschalten, setz AUTO_UPDATE_ENABLED=false in der .env des Projekts.

Nutzt du die Android-App (APK), lade die neueste APK herunter und öffne sie, damit Android die App aktualisiert. Öffne danach Marinara Engine und tipp auf Install / Start Marinara, um die Termux-Kopie zu aktualisieren und zu starten. Ein Update fragt dich nie nach Signaturdaten oder einem Geheimwert.

iPhone und iPad

Diese Geräte führen den Server nicht aus. Das Symbol auf dem Home-Bildschirm ist eine PWA, also eine Website, die auf dem Home-Bildschirm gespeichert ist und sich wie eine App öffnet.

  1. Aktualisiere den Rechner, den Container-Host oder das Android-Gerät, auf dem dein Marinara-Server läuft. Nutz dafür den passenden Abschnitt oben.
  2. Lad die App auf dem Home-Bildschirm oder den Safari-Tab neu.

Zeigt Safari weiterhin einen älteren Build, installier die PWA neu. Siehe Die PWA löschen und neu installieren.

Manuelles Update (Git-Kopie, ohne Launcher)

Nimm diesen Weg, wenn du eine Git-Kopie mit pnpm start statt über den Launcher startest. Führ die Befehle im Marinara-Ordner aus.

  1. Hol den neuesten stabilen Code.
git fetch origin +refs/heads/main:refs/remotes/origin/main
  1. Wechsle darauf.
git merge --ff-only origin/main || git checkout --detach origin/main
  1. Installier die Abhängigkeiten neu, bau die App neu und starte sie.
pnpm install --force --frozen-lockfile
pnpm build
pnpm start

Für die Staging-Version (für Testende) führst du statt der Schritte 1 und 2 diese beiden Befehle aus:

git fetch origin +refs/heads/staging:refs/remotes/origin/staging
git checkout -B staging origin/staging

Warnung: Staging-Builds sind Vorab-Builds für Testende. Sichere deine Daten, bevor du sie verwendest.

Update aus der App heraus

Marinara kann bei GitHub nach einer neueren Version suchen. Manche Installationen können das Update auch aus dem Browser einspielen.

  1. Öffne Settings.
  2. Wechsle zum Tab Advanced.
  3. Such den Abschnitt Updates.

Einen Release-Kanal wählen

Release Channel (Release-Kanal) legt fest, welche Builds du verfolgst.

Wählst du in einem Browser auf dem Rechner des Servers einen anderen Kanal, heißt die Update-Schaltfläche Switch to, gefolgt vom Kanalnamen. Sie funktioniert selbst dann, wenn gewöhnliche Updates in der App abgeschaltet sind, und zeigt Switching…, solange der Wechsel läuft. Entfernte Geräte können das nur, wenn sie die Bedingungen für Apply Update (Update einspielen) unten erfüllen.

Check for Updates

Klick auf Check for Updates (nach Updates suchen). Während der Prüfung zeigt die Schaltfläche Checking…. Darunter siehst du deine Version unter Release, deinen Commit-Code unter Build und, sofern bekannt, deinen Branch.

Die Release-Prüfung bleibt rund 15 Minuten zwischengespeichert, die Zahl der Commits rund 5 Minuten. Ein zweiter Klick direkt danach kann also dieselben Zahlen zeigen.

Schlägt die Prüfung fehl, erscheint „Could not check for updates. Try again later.“ Meist steckt ein Netzwerk- oder GitHub-Problem dahinter.

Apply Update

Apply Update aktualisiert eine Git-Kopie aus dem Browser heraus. Die Schaltfläche erscheint nur, wenn alle diese Punkte zutreffen:

Auf dem Rechner, der den Server ausführt, brauchst du zum Einspielen kein Admin-Secret. Öffne Marinara dort unter http://127.0.0.1:7860 oder http://localhost:7860.

Zwei Einstellungen ändern das:

Das Einspielen von einem anderen Gerät aus ist standardmäßig abgeschaltet. Dafür braucht es alle drei Punkte:

Klick auf Apply Update. Die Schaltfläche zeigt Updating…, während der Server den Code holt, neu installiert, die App neu baut und herunterfährt. Danach erscheint „Update applied successfully. Please relaunch the app to use the new version.“ Starte Marinara erneut, um das Update abzuschließen.

Wenn es nicht funktioniert hat: Fehlt Apply Update, zeigt Marinara den Grund an.

Die App im Browser neu laden

Refresh App (App neu laden) sitzt im selben Abschnitt Updates. Die Schaltfläche aktualisiert nicht den Server. Sie entfernt den Service Worker (ein kleines Skript, mit dem dein Browser die App schnell lädt), leert die Browser-Caches und lädt die Seite dann neu. Deine Chats und Einstellungen bleiben erhalten.

Nutz sie, wenn die App veraltet oder leer aussieht, obwohl der Server schon aktualisiert ist. Während der Arbeit zeigt die Schaltfläche Refreshing….

Deine Daten und optionale Downloads

Ein Update ersetzt den Programmcode, nicht deinen Datenordner oder das Volume marinara-data. Chats, Charaktere, Personas, Lorebooks, Presets, Verbindungen und Einstellungen bleiben, wo sie sind. Wo die Daten liegen, steht unter Marinara sichern und wiederherstellen.

Update von 2.5.0

Die Schritte oben bleiben dieselben. Ein paar Änderungen betreffen einen Server, den andere Geräte oder Personen nutzen. Klapp die Details auf, wenn das auf dich zutrifft.

Downgrade auf eine ältere Version

Ein Rückweg ist nicht immer möglich. Neuere Versionen speichern Daten in einem neueren Speicherformat, und ein Build verweigert Daten in einem Format, das neuer ist als das, das er kennt. Aktuelle Builds verwenden Speicherformat 10. Die Formate 8, 9 und 10 haben MMD-Avatare, die Verknüpfung von Verbindungen mit Konten und GLB/FBX-Avatare hinzugefügt. Ein Build, der nur ein älteres Format kennt, kann Daten in diesen Formaten nicht öffnen.

Der Launcher überspringt ein Auto-Update, das auf einer inkompatiblen Version landen würde, und der Updater in der App verweigert das Einspielen. Um zu einem älteren Build zurückzukehren, stoppe Marinara und stelle ein vollständiges Backup von vor dem Update wieder her. Der Befehl zur Konvertierung von Chat-Dateien unten kann MMD-Avatar-Einstellungen nicht umwandeln. Ändere die Formatnummer nicht von Hand.

Sind deine Daten älter als Speicherformat 8, kann ein einzelner Konvertierungsbefehl die Chat-Dateien in das alte Layout zurückversetzen. Siehe Nach dem Wechsel zu einer älteren Version zeigen Chats keine Nachrichten.

Zurück zu 2.5.0

Version 2.5.0 kann keine Daten öffnen, die auf Speicherformat 8 oder neuer aktualisiert wurden. Verwende ein Backup von vor dem Update.

Bei älteren Daten, die 2.5.0 öffnen kann, kennt die Version nicht, was neuere Funktionen hinzugefügt haben: einige Verbindungseinstellungen, die Angaben zum Neugenerieren von Chat-Bildern sowie Teile von Game-Checkpoints, Uhren aus Regelsätzen und Szenenvideos. Sobald 2.5.0 einen Chat oder eine Verbindung speichert, etwa wenn du eine Nachricht sendest, einen Spielzug machst, ein Bild erstellst oder eine Verbindung änderst, entfernt es diese neueren Daten aus dem gesamten Chat beziehungsweise der gesamten Verbindung. Ein erneutes Update holt sie nicht zurück.

Damit du genau dorthin zurückkehren kannst, wo du warst, leg vor dem Update ein Backup an. Siehe Vorher ein Backup anlegen.

Wenn ein Update fehlschlägt

Die meisten Fehlschläge kommen von einer alten Node.js-Version, einem unvollständigen Download oder einem veralteten Browser-Cache.

Fehlermeldungen und Lösungen findest du unter Fehlerbehebung in Marinara Engine.

Verwandte Anleitungen