Copia de seguridad y restauración de Marinara

Guarda una copia de los datos de tu Marinara Engine y vuelve a ponerla más tarde. Hazlo antes de actualizar, cambiar a un dispositivo nuevo o borrar tus datos.

Cuál elegir

Un .zip es un solo archivo que contiene muchos archivos. Las dos opciones están en Settings → Advanced → Backup & Export. La restauración está en Settings → Imports → Profile & Marinara.

Antes de empezar: en la computadora que ejecuta Marinara, estas herramientas funcionan de inmediato. Desde un teléfono, una tableta o cualquier otro dispositivo, define el secreto de administrador en el servidor y escribe el mismo valor en Settings → Advanced → Admin Access. El secreto de administrador es una contraseña que va en el archivo .env del servidor, como el ajuste ADMIN_SECRET. Consulta la sección "Privileged APIs (ADMIN_SECRET)" de la Referencia de configuración del servidor y de Acceso remoto.

Download Backup

1. Abre Settings.
2. Ve a Advanced.
3. En Backup & Export, haz clic en Download Backup. El botón muestra Creating backup....
4. Guarda el archivo cuando el navegador lo pida, o búscalo en tu carpeta de descargas.

El .zip contiene:

• tus datos de texto guardados (personajes, chats, lorebooks, presets, conexiones, ajustes);
• tus archivos subidos y generados, como avatares, sprites, fondos, imágenes de la galería, fuentes, emoji y stickers personalizados, y tu sonido de notificación personalizado;
• el archivo .encryption-key, cuando existe;
• una nota RESTORE.txt sobre cómo restaurar los archivos a mano (consulta Restaurar a mano).

Para ver los nombres de las carpetas, consulta Dónde guarda Marinara tus datos.

Advertencia: una copia de seguridad contiene tus API keys (claves de API) guardadas y el archivo .encryption-key que las desbloquea. No la compartas nunca. Guárdala en un lugar privado.

En Android no puedes acceder a la carpeta de datos de la app, así que Download Backup es la forma de sacar una copia del dispositivo.

Si no funcionó: si ves "Backup preparation timed out after one hour.", inténtalo de nuevo. Si otro dispositivo no puede descargar, revisa Admin Access (consulta arriba).

Copias de seguridad automáticas

Marinara puede hacer una copia de seguridad completa según un calendario, en la computadora que la ejecuta.

1. Abre Settings → Advanced → Backup & Export.
2. Activa Automatic backups.
3. Elige Daily, Weekly o Monthly.
4. Define Automatic backups kept con un valor de 1 a 9999.

Marinara hace la primera copia poco después de que la actives. Tras cada ejecución conserva las copias automáticas más recientes hasta tu número y borra las automáticas más antiguas. Nunca borra las copias de seguridad que hiciste con Download Backup.

Las copias de seguridad automáticas están en la carpeta backups/ dentro de la carpeta de datos. La más reciente es marinara-automatic-backup.zip. Las más antiguas tienen una fecha y una hora en el nombre. Usan el mismo formato que Download Backup.

Cada ejecución necesita espacio libre para una copia completa más, porque la copia anterior se conserva hasta que termina la nueva. Si no hay espacio suficiente, Marinara omite la ejecución y muestra el motivo junto al ajuste. Lo intenta de nuevo cuando haya espacio libre.

Consejo: guarda una segunda copia fuera de la carpeta de datos. Un disco perdido o una app borrada también eliminan las copias de seguridad automáticas.

Exportar un perfil

1. Abre Settings → Advanced → Backup & Export.
2. Haz clic en Export Profile. Se abre un cuadro de diálogo con el mismo título.
3. Elige un formato.
4. Tu navegador descarga el archivo.

• Marinara Native conserva tus personajes, personas, chats, lorebooks, presets, agentes, temas, el código de Personal Extension y los medios. No restaura las API keys, los enlaces de webhook ni algunos ajustes de chat (consulta Vuelve a escribir tus claves). Puedes restaurarlo en Marinara.
• Compatible JSON crea un .zip de archivos simples de personaje, persona y lorebook para otras herramientas. No puedes restaurarlo en Marinara.

Un perfil nativo se descarga como marinara-profile.json. Si es demasiado grande, Marinara ofrece un archivo ZIP en su lugar. Haz clic en Export ZIP para descargar marinara-profile.zip.

Un perfil nativo conserva el código de Personal Extension, pero no si está activada ni aprobada. Cada extensión restaurada llega desactivada. Revísala de nuevo en Settings → Addons.

Restaurar con Import Profile

Import Profile carga un archivo de perfil o un .zip de Download Backup.

1. Abre Settings → Imports.
2. En Profile & Marinara, haz clic en Import Profile (JSON/ZIP).
3. Elige marinara-profile.json, marinara-profile.zip o un .zip de copia de seguridad. El botón muestra Scanning Profile....
4. Lee el cuadro de diálogo Import Profile. Enumera lo que Marinara encontró y avisa de que no puedes deshacer la importación.
5. Haz clic en Import para continuar, o en Cancel para detenerla. El botón muestra Importing Profile... y aparece una barra de progreso. Cuando termina, un mensaje indica que se importó el perfil.

Si no funcionó:

• A menos que abras Marinara en localhost, 127.0.0.1 o [::1], la importación de perfiles necesita HTTPS. El error es "Profile import requires HTTPS outside local development." Abre Marinara mediante una dirección HTTPS.
• Si a un .zip le faltan algunos archivos de medios, la importación termina igualmente. Una advertencia enumera lo que falta y Marinara importa el resto.

Si importas el mismo perfil dos veces, Marinara actualiza tus elementos y no los copia. Los perfiles de versiones mucho más antiguas pueden crear duplicados.

Vuelve a escribir tus claves

Import Profile nunca recupera las API keys ni los enlaces de webhook, ni siquiera de un .zip de Download Backup. Una API key (clave de API) es el código secreto que te da un servicio. El archivo de perfil y el perfil dentro de una copia de seguridad tienen estos valores en blanco. Por eso, tras importar en una computadora nueva, debes escribirlos de nuevo:

1. Abre Connections (Conexiones) desde la barra superior.
2. Abre cada cuenta que uses, escribe su API key y guárdala. Consulta Conectarse a un proveedor de IA.
3. Escribe el enlace de webhook en cada herramienta personalizada que lo use.

Algunos ajustes con direcciones o claves (Discord, DeepL, Intiface) también vuelven en blanco. Escríbelos de nuevo en los Chat Settings de cada chat.

Importar nunca borra las claves que ya tienes en la misma instalación.

Mudarte a una computadora nueva

1. Instala Marinara en la computadora nueva y ábrela. Consulta Instalación.
2. Abre Settings → Imports → Profile & Marinara y haz clic en Import Profile (JSON/ZIP).
3. Elige tu .zip de Download Backup o tu archivo de perfil, y luego haz clic en Import.
4. Vuelve a escribir tus API keys, como se describe arriba.

El archivo de clave de una copia de seguridad solo te sirve si copias a mano toda la carpeta de datos, como se explica a continuación.

Restaurar a mano

Usa esto solo si no puedes usar Import Profile. El .zip tiene una carpeta dentro, por ejemplo marinara-backup-..., con una nota RESTORE.txt.

1. Detén Marinara.
2. Descomprime la copia de seguridad.
3. Copia las carpetas y el archivo .encryption-key de la carpeta descomprimida a tu carpeta de datos. Consulta Dónde guarda Marinara tus datos.
4. Inicia Marinara.

Mantén el archivo .encryption-key en la carpeta storage, o no se podrán leer las API keys guardadas.

La lista Existing backups de Backup & Export normalmente está vacía. No la necesitas.

Guías relacionadas

• Dónde guarda Marinara tus datos
• Borrar o restablecer tus datos
• Actualizar Marinara Engine
• Conectarse a un proveedor de IA
• Acceso remoto: inicio de sesión y lista de IP permitidas