Copias de seguridad
Dos cosas hay que respaldar. Una sola no sirve.
Base de datos
Todo el estado del negocio: cuentas, workspaces, canales, publicaciones, planes, cobros y ajustes.
pg_dump -Fc "$DATABASE_URL" > zapi-$(date +%F).dumpRestaurar:
pg_restore -d "$DATABASE_URL" --clean --if-exists zapi-2026-08-26.dumpVolumen de archivos
Todo lo que subieron tus clientes, más las miniaturas y las variantes con marca de agua.
Está en la ruta de FILES_STORAGE_PATH.
En Dokploy, el nombre del volumen es FILES_VOLUME_NAME y los contenedores api y
worker lo montan en /var/lib/zapi/files. En el Compose completo, la ruta interna
es /app/.data/files. Ejecuta la copia donde esté montado el volumen y usa esa ruta.
tar czf zapi-files-$(date +%F).tar.gz -C "$FILES_STORAGE_PATH" .La base y el volumen tienen que respaldarse a la vez. Si restauras una base de hoy con archivos de la semana pasada, quedan publicaciones apuntando a archivos que no existen.
La clave de cifrado
PROVIDER_INTEGRATIONS_ENCRYPTION_KEY no está en la base ni en el volumen: está en tus
variables de entorno. Guárdala aparte, en tu gestor de contraseñas.
Sin ella, una copia restaurada no puede descifrar ni un solo canal conectado. Es el único dato que, si se pierde, no se recupera de ninguna copia.
Redis y colas
Redis contiene trabajos pendientes y el estado de las colas. Mantén su persistencia durante actualizaciones y revisa su respaldo si necesitas recuperar esos trabajos. La caché puede regenerarse; eso no recupera automáticamente todos los trabajos perdidos.
Las imágenes de Docker se reconstruyen desde el repositorio: conserva la versión del código y la configuración del despliegue.