Actualizar
Leer las notas de la versión
Mira si la versión incluye migraciones o variables nuevas antes de tocar nada.
Hacer copia
Base de datos y volumen de archivos. Ver Copias de seguridad.
Aplicar migraciones
El Compose de API en Dokploy no migra al arrancar. Si la versión incluye migraciones, aplícalas con el código nuevo, una conexión verificada y un rol autorizado antes de iniciar los contenedores que dependan de ese esquema:
bun --filter @workspace/database db:migrateDesplegar API con su Worker
Publica la versión en la rama configurada y despliega API desde
docker-compose.backend.yml. Sus contenedores api y worker se gestionan juntos.
Conserva FILES_VOLUME_NAME, PostgreSQL, Redis y la clave de cifrado.
Comprueba /v1/health y los registros de worker en Containers. El margen de
cierre de Worker permite terminar trabajos activos antes de forzar su parada.
Desplegar Web
Despliega la Application con Dockerfile.web, contexto . y etapa vacía. Conserva
PORTAL_HOST y los dominios del panel y del sitio público.
Comprobar
Repite las comprobaciones tras instalar. Son siete y te ahorran descubrir un problema por un cliente.
La API debe admitir el contrato que usa Web antes de actualizar el frontend. En la
instalación con docker-compose.yml, el servicio migrate se ejecuta antes de
arrancar API y Worker; ese mecanismo pertenece al Compose completo.
Si algo sale mal
Revisa los registros y la versión anterior antes de volver a desplegarla. Comprueba su compatibilidad con el esquema actual: cambiar la imagen no revierte migraciones. Conserva el volumen Files y la copia de seguridad durante la recuperación.