Saltar al contenido principal

Backups de bases de datos

Backup/restore nativo de bases de datos gestionadas por Dokploy (Postgres, MySQL, MariaDB, MongoDB). Para SQLite o apps sin BD gestionada, ver Volume Backups. Requiere primero un destino S3.


1. Para qué sirve

Protege contra pérdida de datos si el contenedor de la BD se corrompe o el servidor muere. Dokploy programa un dump periódico y lo sube a un bucket S3.

Sin esto: si el droplet muere, los datos se pierden por completo (salvo que la BD corra en un servicio externo tipo Atlas/RDS).

2. Configurar un Backup

Pestaña Backup del servicio de BD:

CampoQué es
Destination S3 BucketEl destino de Settings → Destinations
Database NameBD a respaldar
Schedule (Cron)Frecuencia del backup
PrefixCarpeta dentro del bucket
EnabledActiva/desactiva

Botón Test → dispara un backup de prueba. Verificar en el bucket que el archivo aparezca antes de confiar.

3. Restaurar desde S3

Pestaña Backup → Restore: elegir el bucket, buscar el archivo (autocompleta, soporta rutas anidadas), indicar la BD destino, Restore Database.

Solo se garantiza restaurar backups generados por el propio Dokploy — detecta el formato y usa el comando correcto. Otros orígenes no tienen garantía.

4. Comandos que usa por debajo

Útil para entender qué hace "Test" o reproducir el dump a mano:

# Postgres
pg_dump -Fc --no-acl --no-owner -h localhost -U ${user} --no-password '${db}' | gzip
# MySQL
mysqldump --single-transaction --no-tablespaces --quick -u root --password='${pass}' '${db}' | gzip
# MongoDB
mongodump -d '${db}' -u '${user}' -p '${pass}' --archive --authenticationDatabase=admin --gzip

5. Lo que este backup NO cubre

Es fácil asumir que "tengo backups activados" cubre todo. No. Solo cubre los datos de la BD. Si el servidor muere, además necesitas:

Qué¿Lo cubre?
Datos de la BD✅ Este backup, en S3
Código fuenteNo aplica — ya está en Git
Env vars, dominios, config de Dokploy❌ Necesitas el backup del propio Dokploy (Settings → Web Server → Backup)
Uploads de la app❌ Backup independiente, ver S3 §2.2

Si el servidor muere y solo tenías el backup de la BD, al recrearlo igual hay que reconectar el repo y reescribir todas las env vars a mano — eso lo protege el backup de configuración de Dokploy, no el de la BD.


📖 docs.dokploy.com/docs/core/databases