Server-Konfiguration – Referenz

In dieser Anleitung erfährst du, welche Server-Einstellungen du über Umgebungsvariablen ändern kannst. Umgebungsvariablen sind Einstellungen, die der Server aus einer einfachen Textdatei namens .env liest. Marinara funktioniert ganz ohne Konfiguration. Die meisten brauchen sie nur, um andere Geräte zuzulassen, einen gemeinsam genutzten Server zu schützen, den Datenordner zu verschieben, ausführlicheres Logging einzuschalten oder langsamen Aufträgen mehr Zeit zu geben.

Deine KI-Konten, Charaktere und Chat-Optionen stellst du in der App ein. Wie du ein KI-Konto hinzufügst, steht unter Verbindung zu einem KI-Anbieter herstellen.

Die .env-Datei bearbeiten

Marinara legt beim ersten Start eine leere .env an. Jede Zeile hat die Form KEY=value. Zeilen, die mit # beginnen, sind Kommentare.

1. Öffne .env.example im selben Ordner. Dort steht jede Einstellung mit ihrem Standardwert.
2. Kopiere die gewünschte Zeile nach .env.
3. Ändere den Wert hinter dem = und speichere die Datei.

PORT=8080
BASIC_AUTH_USER=alice
BASIC_AUTH_PASS=correct-horse-battery-staple

.env enthält Daten, kein Shell-Skript. Marinara führt $, $(...) und sonstige Shell-Syntax in einem Wert nicht aus. Ein Wert, der bereits in der Umgebung des Launchers gesetzt ist, hat Vorrang vor dem gleichen Eintrag in .env.

Der Server liest .env, ganz gleich, wie du ihn startest. Die Launcher (start.bat, start.sh, start-termux.sh) setzen außerdem HOST=0.0.0.0, damit andere Geräte sich verbinden können, und öffnen deinen Browser, sobald der Server bereit ist. AUTO_OPEN_BROWSER=false schaltet das ab. Bei einem nackten pnpm start lauscht der Server nur auf diesem Rechner, solange du HOST nicht setzt.

Neustart oder Hot Reload

Marinara überwacht .env im laufenden Betrieb. Die meisten Einstellungen greifen fast sofort, ohne Neustart. Für jede Änderung zeigt das Log eine Zeile [env-watcher]. Lässt sich die Überwachung nicht starten, prüft der Server die Datei alle 30 Sekunden und vermerkt das im Log.

Werden deine Änderungen nicht übernommen, etwa weil du von einem anderen Rechner aus oder in einem Bind-Mount eines Containers bearbeitest, setze MARINARA_ENV_WATCH=poll. Um die Überwachung abzuschalten, setze MARINARA_ENV_WATCH=0. Beides sind Optionen für Fortgeschrittene.

Die folgenden Einstellungen liest der Server nur beim Start. Eine Änderung braucht einen Neustart, und das Log weist dich darauf hin:

• PORT, HOST, SSL_CERT und SSL_KEY
• DATA_DIR, FILE_STORAGE_DIR, ENCRYPTION_KEY und MARINARA_EAGER_STORAGE
• MARINARA_ENV_FILE, MARINARA_ENV_WATCH und TZ
• AUTO_OPEN_BROWSER und AUTO_CREATE_DEFAULT_CONNECTION
• LOG_DISABLE_REQUEST_LOGGING und LOG_FORMAT
• STORAGE_CACHE_WINDOWS_BOOT_ID, SHUTDOWN_WINDOWS_CONSOLE_SIGNALS und SHUTDOWN_FORCE_EXIT_ON_REPEAT
• Zeitlimits und Abfrage-Einstellungen für Bild, Video, Sprite und ComfyUI: IMAGE_GEN_TIMEOUT_MS, IMAGE_GEN_MAX_RESPONSE_BYTES, VIDEO_GEN_TIMEOUT_MS, VIDEO_GEN_MAX_RESPONSE_BYTES, SPRITE_GENERATION_TIMEOUT_MS, SPRITE_ANIMATED_FFMPEG_TIMEOUT_MS, COMFYUI_GEN_TIMEOUT und die vier *_VIDEO_POLL_INTERVAL_MS-Einstellungen

Die Launcher lesen AUTO_UPDATE_ENABLED, bevor der Server startet. Eine Änderung gilt daher ab dem nächsten Start, und das Log weist nicht darauf hin.

Einstellungen zur Zugriffskontrolle und Geheimnisse (BASIC_AUTH_USER, BASIC_AUTH_PASS, IP_ALLOWLIST, ADMIN_SECRET, CSRF_TRUSTED_ORIGINS) kommen ohne Neustart aus.

Zugriffskontrolle

Die Zugriffskontrolle entscheidet, wer einen laufenden Server erreichen darf. Schritte und Beispiele findest du unter Fernzugriff: Anmeldung und IP-Allowlist.

Die Anmeldung lässt sich auch ohne .env einrichten: über Settings → Advanced → Access (Einstellungen → Erweitert → Zugriff) in einem Browser, der schon angemeldet ist, oder mit dem einmaligen Einrichtungscode aus dem Server-Log. Der Server gibt diesen Code nur aus, solange keine Anmeldung gesetzt ist und er über Loopback hinaus lauscht. Die Anmeldung wird in DATA_DIR/.remote-login.json gespeichert. node scripts/reset-login.mjs (im Marinara-Ordner ausgeführt) entfernt sie und meldet jeden Browser ab. Eine Anmeldung in .env hat Vorrang. Um die Anmeldung zu ändern oder zu entfernen, brauchst du das aktuelle Passwort. Zu Login-Proxys siehe Login-Proxys (Forward-Auth).

Begriffe, die unten vorkommen:

• Loopback: der Rechner, auf dem der Server läuft, erreichbar unter 127.0.0.1 oder localhost.
• CIDR-Bereich: eine Kurzschreibweise für einen Block von IP-Adressen, etwa 192.168.1.0/24.
• Basic Auth: Benutzername und Passwort, die mit jeder Anfrage mitgeschickt werden. Skripte und API-Clients nutzen das, Browser nutzen die Seite /login. Die Zugangsdaten sind nur kodiert, nicht verschlüsselt; nutze deshalb auf einem öffentlichen Server HTTPS.

Ohne gesetzte Anmeldung nimmt der Server nur Verbindungen aus vertrauenswürdigen Quellen an: Loopback, Adressen in IP_ALLOWLIST, Tailscale und Docker-Bridge-Verkehr vom selben Host. Alle anderen, auch dein Heimnetzwerk, bekommen 403 Forbidden. Damit andere Geräte sich überhaupt verbinden können, muss der Server an eine erreichbare Adresse gebunden sein: Setze HOST=0.0.0.0.

Warnung: Ein breiter öffentlicher IP_ALLOWLIST-Bereich wie 0.0.0.0/0 kann Internet-Clients ohne Anmeldung hereinlassen. Trag nur Adressen ein, denen du vertraust.

Speicherung

Erzeuge einen Verschlüsselungsschlüssel und füge ihn bei ENCRYPTION_KEY ein:

openssl rand -hex 32

Marinara legt deine Daten als einfache JSON-Dateien ab, sodass du Backups kopieren und lesen kannst. Was in welchem Ordner steckt, erklärt Wo Marinara deine Daten speichert.

Log-Stufen

LOG_LEVEL legt fest, wie viel der Server ausgibt. Alles unterhalb der gewählten Stufe blendet er aus.

In einem Terminal gibt der Server lesbare Zeilen aus. Anderswo, etwa in Docker-Logs, gibt ein Produktionsserver JSON-Zeilen aus. Der Termux-Launcher fordert lesbare Zeilen an. Das Browser-Logging läuft getrennt davon und richtet sich nicht nach LOG_LEVEL.

Zeitlimits

Ein Zeitlimit ist die längste Zeit, die der Server auf einen langsamen Auftrag wartet. Unter Settings → Advanced → Request timeouts stellst du die Limits für Text, Agenten, Game-Bildprompts, Bilder, Videos, ComfyUI und Embeddings in Sekunden ein. Höhere Limits helfen langsamen lokalen Backends. Ein Limit, das der Dienst selbst setzt, können sie nicht aufheben. Zum Speichern brauchst du Administrationszugriff auf den Server.

Diese Einstellungen gelten für alle Profile und werden neben der aktiven .env als .env.timeouts.json gespeichert (oder als <custom-env-path>.timeouts.json). Sie überschreiben die passenden Variablen, ohne .env zu ändern. Änderungen für Text, Agenten, Game-Bildprompts und Embeddings gelten für neue Anfragen. Medienänderungen und installierte Agentenpakete brauchen einen Neustart. Um wieder die Variablen zu nutzen, lösch diese Datei und starte neu.

Die Werte sind in Millisekunden angegeben, sofern der Name nichts anderes sagt. Ungültige Werte, null, negative Werte oder Werte außerhalb des Bereichs erzeugen bei den geprüften Zeitlimits für Chat, Agenten und Game-Bildprompts eine Warnung im Log, und der Standard gilt. Mehr zu Video-Aufträgen steht unter Szenenvideos generieren.

Privilegierte APIs (ADMIN_SECRET)

Zerstörerische oder riskante Aktionen wie Backups, das Löschen von Daten, das Einspielen von Updates und das Installieren von Themes brauchen zusätzlich zu den normalen Zugriffsprüfungen ein Geheimnis. Du kannst eines auf dem Server-Rechner selbst unter Settings → Advanced → Admin Access erstellen (siehe Admin Access) oder auf dem Server einen langen, zufälligen Wert setzen:

ADMIN_SECRET=replace-this-with-a-long-random-secret

Auf dem Rechner, auf dem der Server läuft, funktionieren diese Aktionen meist auch ohne das Geheimnis. Eine Anfrage, die ein Proxy oder Tunnel auf diesem Rechner weiterleitet, zählt als entfernt, außer bei REQUIRE_AUTH_FOR_LOOPBACK_PROXY=false. Direkte Anfragen von einem anderen Gerät brauchen das Geheimnis. Füge denselben Wert unter Settings → Advanced → Admin Access ein, dann schickt die App ihn für dich mit. ADMIN_SECRET in der .env hat Vorrang vor einem in der App erstellten Geheimnis. Ohne Admin-Secret scheitern privilegierte Aktionen von jedem Gerät außer dem Server-Rechner selbst, und die Fehlermeldung fordert dich auf, eines einzurichten. Installierte Agenten funktionieren auf jedem Gerät, das mit der Anmeldung angemeldet ist; zum Installieren, Aktualisieren und Entfernen brauchst du das Geheimnis.

Freigaben für lokale Adressen

Standardmäßig verweigern ausgehende Anfragen an KI-Dienste, Bilddienste und Webhooks private oder lokale Adressen. Das blockiert SSRF (Server-Side Request Forgery), bei der eine Anfrage dazu verleitet wird, eine interne Adresse anzusprechen. Modell-Server im Loopback funktionieren weiterhin. Aktiviere nur den Schalter, den du für einen selbst gehosteten Dienst auf einem anderen Rechner im privaten Netzwerk brauchst.

Wie du ein lokales oder selbst gehostetes Modell anbindest, steht unter Ein lokales oder selbst gehostetes Modell verbinden.

Funktionsschalter

Optionale Serverfunktionen, etwa das Wiederholen fehlgeschlagener Anbieteraufrufe oder stabile Lorebook-Gruppenauswahlen, findest du unter Settings → Advanced → Features (Einstellungen → Erweitert → Funktionen). Alle sind standardmäßig aus. Einige haben eine Variable, die Vorrang vor dem Schalter hat, wenn sie gesetzt ist. Siehe Funktionsschalter.

Marinara-Hinweise

Hinweise sind kurze Warnungen der Maintainer, etwa zu einem Sicherheitsproblem oder zu einem manuellen Schritt, den deine Version braucht. Sie erscheinen als Banner.

• Beim Start und danach jede Stunde lädt der Server eine kleine Datei, notices.json, aus dem Branch notices des Marinara-Engine-Repositorys herunter. Er behält nur die Hinweise, die deine Version nennen. Dein Browser fragt sie einmal beim Laden der Seite und danach stündlich bei deinem eigenen Server ab.
• Schlägt ein Download fehl, behält der Server die Hinweise, die er schon hat, und der Start verzögert sich nicht.
• Die Anfrage sendet keine Daten über dich, deine Chats oder deine Einstellungen. Nur Maintainer können den Branch notices ändern, und jede Änderung wird geprüft.
• Ein Hinweis ist reiner Text mit Größenbegrenzung. Links bleiben nur erhalten, wenn sie auf https://github.com/Pasta-Devs/ zeigen. Ein Hinweis kann nichts installieren, ausführen oder ändern.
• Nur du siehst Hinweise: auf dem Server-Rechner selbst, von einer Adresse in IP_ALLOWLIST aus oder nachdem du dich angemeldet hast. Andere Besucher bekommen eine leere Liste.

Zum Abschalten der Hinweise setze MARINARA_NOTICES_ENABLED=false.

Warnung: Sind die Hinweise aus, kann Marinara dir keine Sicherheitskorrekturen oder erforderlichen Schritte mitteilen. Behalte die GitHub-Releases dann selbst im Blick.

Forks können MARINARA_NOTICES_URL auf ihre eigene Datei zeigen lassen.

Optionaler Mehrspielermodus

Der Mehrspielermodus ist standardmäßig aus. Mit ihm teilen sich mehrere Personen einen privaten Conversation-, Roleplay- oder Game-Raum, ohne feste Obergrenze für die Teilnehmerzahl. Jeder Gast nutzt sein eigenes vertrauenswürdiges Marinara. Gäste brauchen kein KI-Konto. Der Host stellt die KI-Konten bereit und kann geteilte Inhalte lesen und aufbewahren. Solange eine der beiden Sicherheitssperren geschlossen ist, führt Marinara keine Sitzungs-, Zertifikats- oder Gegenstellenprüfungen im Hintergrund durch.

1. Setze MULTIPLAYER_ENABLED=true in der .env jedes teilnehmenden Marinara und starte es neu. Nur der exakte Wert true wirkt, und Hot Reload übernimmt ihn nicht.
2. Öffne Settings → Advanced → Multiplayer (Einstellungen → Erweitert → Mehrspieler), lies die Warnung und schalte die Einstellung ein. Das startet weder einen Listener noch einen Raumbeitritt.
3. Zum Hosten nutzt du Create shared session (geteilte Sitzung erstellen) oder Play together (zusammen spielen) im Modus- oder Einrichtungsablauf. Prüfe die Einrichtung, deinen Anzeigenamen und den Persona-Text, den du teilst. Ein bestehender Chat teilt nur seine Einrichtungsauswahlen, nie seinen Verlauf, seine Notizen oder Erinnerungen.
4. Setze auf dem Host SSL_CERT und SSL_KEY für ein Zertifikat, das für den Raum-Hostnamen gültig ist und dem die Gäste vertrauen. Wähle eine eigene HTTPS-Raumadresse mit eigenem Port, etwa https://room.example.org:7861. Die Host-Aktion öffnet diesen Port. Leite nur den Raum-Port durch Firewall oder Router. Veröffentliche nicht die normale Marinara-API. Portweiterleitung, Relay oder eine Umgehung der Zertifikatsprüfung werden nicht für dich eingerichtet.
5. Lege ein Raumpasswort mit mindestens 12 Zeichen fest, das sich von deinen Admin-Zugangsdaten unterscheidet. Schick die ablaufende Einladung und das Passwort getrennt an Personen, denen du vertraust. Der Gast prüft Hostnamen-Fingerabdruck, Raumnamen und Persona-Text und bittet dann um Aufnahme. Der Host bestätigt jede Anfrage unter Players (Spieler), bevor Verlauf gesendet wird.

Grenzen und Verhalten:

• TLS prüft Zertifikatskette und Hostnamen sowie den Zertifikatsfingerabdruck der Einladung, bevor ein Passwort gesendet wird. Selbst signierte Zertifikate werden nicht stillschweigend akzeptiert. Ein erneuertes Zertifikat braucht eine neue Einladung.
• Einladungen verfallen nach 30 Minuten. Zugelassene Sitzungen dauern höchstens 12 Stunden. Ersetzen oder Widerrufen stoppt unbenutzte Einladungen. Kick (hinauswerfen) entfernt einen aufgenommenen Gast.
• Der Host steuert automatische oder manuelle Antworten, Pause/Resume (pausieren/fortsetzen) und Stop (stoppen). Standardmäßig gibt es 100 koordinierte Generierungszüge pro Host-Sitzung. Ein Gruppenzug oder eine Game-Einrichtung kann mehr als einen Modellaufruf auslösen. Das ist ein Zuglimit, keine Preisschätzung.
• Prüfe in Game vor Start Game (Spiel starten) die Gruppe. Jeder erforderliche Spieler reicht eine Aktion ein oder passt, und der GM wertet aus, wenn alle bereit sind. Ein getrennter Spieler bleibt erforderlich, bis er zurückkehrt oder der Host für ihn passt oder ihn entfernt. Pausierte oder unterbrochene Runden wiederholen nie von selbst eine kostenpflichtige Anfrage oder bereits gespeicherte Welteffekte.
• Stop, Leave (verlassen), das Ausschalten der Einstellung und ein Serverneustart beenden die laufende Sitzung. Ein Neustart hostet nie von selbst und tritt keinem Raum von selbst bei.
• Eigene Tools, Paket-Tools und unsichere Befehle bleiben in Räumen gesperrt. Gäste führen nie einen Scheduler oder lokale Befehle aus empfangenem Text aus. Conversation-Zeitpläne nutzen den Scheduler des Hosts.
• Neue Spieler und Persona-Änderungen gelten ab der nächsten Runde.
• Räume übertragen nur begrenzten Text. Es gibt keine Übertragung von Dateien, Medien, Erweiterungen oder Paketen. Der native Android-Wrapper kann nicht beitreten.

Warnung: Verbinde dich nur mit Personen, denen du vertraust, und nutze deinen eigenen Marinara-Client. Installiere nie einen vom Host gelieferten Client, eine Erweiterung oder Datei. Der Host kann lesen, was du teilst, und geteilte Inhalte können an seine KI-Dienste gehen. Direkte Verbindungen legen Netzwerkadressen offen. Teile keine Passwörter, API-Keys oder persönlichen Daten. Verlasse den Raum sofort, wenn dir etwas seltsam vorkommt.

Genaue Einschränkungen und getestete Plattformen nennt der Kompatibilitäts- und Prüfbericht. Bei Problemen hilft Fehlerbehebung weiter.

Agenten und Erweiterungen

Optionale offizielle Agenten installierst du in der App: Agents → Agent Organizer (Agenten → Agentenverwaltung). Marinara wählt den Katalog von Pasta-Devs/Marinara-Agents, der zu seiner Hauptversion passt.

• Updates: Marinara fragt nach, bevor es eine neue Version eines installierten Pakets herunterlädt. Not now (jetzt nicht) behält die aktuelle Version, und Update bleibt in Agent Organizer verfügbar. Eine frische Installation hat keine Pakete.
• Speicherort der Pakete: DATA_DIR/capability-packages. Docker-Volumes, eigene Datenordner, Backups und normale Updates lassen sie unangetastet. Das gilt für Desktop, Docker und Termux. iOS und andere Browser nutzen die Pakete auf ihrem Host-Server.
• Speicherplatz: Marinara behält von jedem Paket die aktuelle und die vorherige Version und löscht ältere Versionen sowie die temporären Kopien in DATA_DIR/capability-runtime-snapshots. Paketdaten werden nie gelöscht.
• Offline: Installierte Pakete laufen in ihrer Version weiter, wenn GitHub nicht erreichbar ist, ein Update abgelehnt wird oder die Prüfung fehlschlägt.

Import eigener Agenten

Externe Agent-Dateien, -Ordner und -Repositorys sind gesperrt. Um sie zu erlauben, schalte Allow custom Agent imports (Import eigener Agenten erlauben) unter Settings → Advanced → Danger Zone (Einstellungen → Erweitert → Gefahrenbereich) ein. Dafür brauchst du keine Umgebungsvariable. Bis dahin bleiben die Import-Bedienelemente ausgegraut.

Jeder Import zeigt zuerst, welche Fähigkeiten der Agent anfordert. Berechtigungen musst du ausdrücklich bestätigen. Mitgelieferte Funktionen und Tool-Auswahlen werden nicht importiert, generiertes CSS wird bereinigt, und Ergebnis-Aktionen werden gegen die freigegebenen Fähigkeiten geprüft. Schaltest du die Freigabe aus, laufen importierte Agenten nicht mehr. In Marinara erstellte Agenten und offizielle Pakete sind davon nicht betroffen.

Eigene Agent-Repositorys

Repositorys sind standardmäßig aus, weil ihre Prompts und Tools ungeprüft sind. Setze ENABLE_CUSTOM_AGENT_REPOS=true, schalte Allow custom Agent imports ein und öffne dann Agents → Agent Organizer → Custom Sources, um ein öffentliches GitHub-Repository in der Vorschau anzusehen. Sowohl das Hinzufügen einer Quelle als auch das Übernehmen späterer Änderungen musst du bestätigen. Die Synchronisierung läuft manuell, und Marinara klont Repositorys nie und fragt sie nie im Hintergrund ab. Akzeptiert werden nur GitHub-URLs zum Stammverzeichnis eines Repositorys.

Ein Repository veröffentlicht Agenten, Game-Mode-Regelsätze oder beides. Im Stammverzeichnis:

• agents.json ist ein Array im Format herunterladbarer Agenten:

  [
    {
      "id": "continuity-helper",
      "name": "Continuity Helper",
      "description": "Checks recent turns for contradictions.",
      "phase": "post_processing",
      "enabledByDefault": false,
      "category": "writer",
      "defaultPromptTemplate": "Check {{messages}} for continuity errors."
    }
  ]

• rulesets enthält einen Regelsatz pro .json-Datei, höchstens 32 Dateien mit je bis zu 512 KB. Gelesen werden nur Dateien direkt darin. Die Vorschau listet für jeden Regelsatz Name, Version und Abdeckung auf. Der Game-Master-Text eines Regelsatzes geht in jedem Spiel, das ihn nutzt, an das Modell; installiere deshalb nur von Leuten, denen du vertraust.

Importierte Regelsätze werden nach dem Eigentümer des Repositorys benannt, etwa alice/my-5e, und nehmen so nie einen offiziellen Namen an. Jede Version bleibt erhalten, und ein Spiel läuft mit genau der Version, mit der es begonnen hat. Kommt dieselbe Version mit anderem Inhalt an, behält Marinara die installierte und weist dich darauf hin, den Autor um eine höhere Versionsnummer zu bitten. Eine Datei, die Marinara nicht lesen kann, wird mit Begründung aufgeführt und übersprungen.

Bei der Synchronisierung ersetzen die Prompt-, Einstellungs- und Tool-Werte aus dem Repository die vom Repository verwalteten Werte, die die Vorschau zeigt. Deine Auswahl von Konten und Bildern bleibt lokal. Verschwindet ein Agent aus dem Repository, bleibt er als normaler lokaler Agent erhalten und verliert nur seine Repository-Verknüpfung. Beim Entfernen einer Quelle gilt dasselbe, und ihre Regelsätze bleiben installiert.

Eigene Agenten können außerdem unter Context Sources die Option Previous output (vorherige Ausgabe) einschalten, um ihre eigene letzte erfolgreiche Ausgabe zu lesen. Gib bei JSON context output (Kontextausgabe als JSON) {"text":"main prompt content","agent-context":"private continuation context"} zurück. Nur text kommt in den Haupt-Prompt. Hide output as spoilers (Ausgabe als Spoiler verbergen) hält gespeicherte Ausgaben eingeklappt. Beim Neugenerieren bleibt der ersetzte Zug außen vor, und gelöschte Nachrichten oder inaktive Swipes können keinen Kontext liefern.

External Extensions

Der Import von Erweiterungen Dritter braucht zwei Freigaben. Die Umgebungsvariable ist die Erlaubnis des Server-Betreibers. Der Schalter in der Danger Zone ist die Zustimmung des Nutzers.

1. Setze ENABLE_EXTERNAL_EXTENSIONS=true in .env.
2. Öffne Settings → Advanced → Danger Zone, scrolle unter die Bedienelemente zum Löschen von Daten, lies die Warnung und schalte Allow third-party extension imports (Importe von Fremdanbietern erlauben) ein.

Danach erscheint der Bereich External Extensions unter Settings → Addons. Wird eine der beiden Sicherheitssperren geschlossen, deaktiviert Marinara externe Einträge und stoppt ihren Code. Manuell abgelegte, alte und per Profil importierte Einträge gelten ebenso als extern wie solche unbekannter Herkunft; Dateien einfach in einen Ordner zu legen, umgeht die Sicherheitssperren also nicht. Für Entwürfe von Professor Mari muss keine der beiden Sicherheitssperren offen sein. Sie werden deaktiviert angelegt, und ihr exakter Code-Hash muss freigegeben werden.

Standard sind Browser-Erweiterungen in der Sandbox. Manche älteren Pakete zeigen Full page access (Vollzugriff auf die Seite), weil sie die Marinara-Seite brauchen. In diesem Modus läuft der freigegebene Code in der Marinara-Seite und hat Zugriff auf Seiteninhalte, Browser-Speicher, Netzwerk-APIs und deine Sitzung. Er steht nur External Extensions offen, wenn beide Sicherheitssperren offen sind, und verlangt eine eigene Bestätigung der Warnung. Lade die Seite neu, nachdem du ihn deaktiviert hast.

Vollständige Referenz der Umgebungsvariablen

Die Tabellen weiter oben decken Zugriffskontrolle, Speicherung, Logging, Zeitlimits, privilegierte Aktionen und Freigaben für lokale Adressen ab. Die übrigen Einstellungen stehen hier.

Server und Start

Schedule timezone nutzt standardmäßig die Zeitzone deines Geräts. Du kannst sie bei der Einrichtung von Conversation, in den Conversation Chat Settings oder im Zeitplan-Editor des Charakters ändern. Sie ist eine einzige globale Einstellung für alle Conversation-Chats und wird mit anderen Clients am selben Server abgeglichen.

Medien- und Sprite-Werkzeuge

Anbieter für Szenen-Videos

Video-Konten richtest du in der App ein. Diese Einstellungen justieren nur die Aufträge. Die Werte sind in Millisekunden.

Lorebooks

Beide Einstellungen sind standardmäßig aus und gelten nach einer .env-Änderung ab der nächsten Generierung. Ist LOREBOOK_STABLE_GROUP_WINNERS gesetzt, hat die Variable Vorrang vor dem Schalter Stable lorebook picks (stabile Lorebook-Auswahl) unter Settings → Advanced → Features. Sonst entscheidet der Schalter. Siehe Funktionsschalter.

scripts/compact-lorebook-scans.mjs wendet dieselbe Regel auf ältere Chats an. Stoppe zuerst den Server. Ohne --apply bleibt es ein Probelauf, und vor dem Schreiben sichert es beide Nachrichtentabellen.

Robustheit

Alle sind standardmäßig aus und behalten so das bisherige Verhalten bei. STORAGE_CACHE_WINDOWS_BOOT_ID, SHUTDOWN_WINDOWS_CONSOLE_SIGNALS und SHUTDOWN_FORCE_EXIT_ON_REPEAT brauchen einen Neustart. Die übrigen gelten nach einer .env-Änderung. Ist PROVIDER_RETRY_TRANSIENT_ERRORS gesetzt, hat die Variable Vorrang vor dem Schalter Retry failed provider calls (fehlgeschlagene Anbieteraufrufe wiederholen) unter Settings → Advanced → Features. Sonst entscheidet der Schalter.

Integrationen und Extras

Zum Built-in model siehe Eingebautes Modell einrichten.

Ausgehender HTTP-Proxy

Manche Netzwerke erreichen das Internet nur über einen HTTP-Proxy, zum Beispiel v2rayN ohne TUN-Modus. Marinara kann seine Anfragen an KI-Dienste, Bilddienste, Embedding-Server und den Agenten-Katalog über diesen Proxy schicken. Setze die folgenden Werte in der Umgebung, die Marinara startet, oder in .env und starte dann neu.

Verwandte Anleitungen

• Funktionsschalter
• Fernzugriff: Anmeldung und IP-Allowlist
• Wo Marinara deine Daten speichert
• Verbindung zu einem KI-Anbieter herstellen
• Szenenvideos generieren
• Fehlerbehebung in Marinara Engine