Cómo hacer copia de seguridad y restaurar Coolify en 12 minutos
Hoy tu servidor se siente seguro. Pasaste horas configurando Coolify. Alojas tus propias aplicaciones, bases de datos y blogs. Te sientes en control.
Entonces ocurre un desastre. Tu proveedor de VPS cierra tu región. Ejecutas un comando incorrecto. El servidor muere.
Si no tienes copias de seguridad, lo pierdes todo. Esta guía evita eso. Puedes configurar copias de seguridad automatizadas y una restauración completa en 12 minutos.
Paso 1: Configurar el almacenamiento S3
Coolify necesita un lugar para guardar las copias de seguridad. Usa un almacenamiento compatible con S3. Cloudflare R2 es una excelente opción porque tiene cero tarifas de salida (egress fees).
Necesitas estos detalles de tu proveedor de almacenamiento:
- Endpoint
- Región
- Access Key
- Secret Key
- Nombre del bucket (Bucket Name)
En Coolify, ve a la pestaña S3 Storage. Añade tus detalles y haz clic en Validate Connection.
Paso 2: Habilitar copias de seguridad automatizadas
Ve a Settings y luego a Backup.
- Activa S3 Backup.
- Activa Backup.
- Selecciona tu fuente de almacenamiento S3.
- Establece la frecuencia en Daily.
Ejecuta una copia de seguridad manual de inmediato. Revisa tu bucket de S3 para confirmar que el archivo existe.
Paso 3: Guarda tu APP_KEY
Este es el paso más importante. Coolify cifra tus datos. Si pierdes esta clave, tu copia de seguridad será inútil.
Accede por SSH a tu servidor y ejecuta:
cat /data/coolify/source/.env
Busca la línea que comienza con APP_KEY. Copia este valor. Guárdalo en un gestor de contraseñas. No te saltes este paso.
Paso 4: Restaurar en un nuevo servidor
Si tu servidor muere, sigue estos pasos en tu nuevo VPS:
- Instala Coolify usando el comando curl estándar.
- Descarga tu archivo .pgdump desde tu bucket de S3 al nuevo servidor.
- Ejecuta el comando de restauración:
sudo docker exec -i coolify-db pg_restore --username coolify --verbose --dbname coolify < /path/to/your-backup.pgdump
Es posible que veas advertencias sobre tablas existentes. Ignóralas. Aun así funciona.
Paso 5: Corregir el error 500
Después de restaurar, es posible que veas un error 500 al hacer clic en las aplicaciones. Esto sucede porque el nuevo servidor tiene una APP_KEY diferente.
Para solucionar esto:
- Abre tu nuevo archivo .env:
nano /data/coolify/source/.env - Añade esta línea: APP_PREVIOUS_KEYS=base64:your-old-app-key
- Guarda y reinicia Coolify usando el script de instalación.
Ahora tus datos antiguos vuelven a ser legibles.
Lista de verificación:
- Configurar el almacenamiento S3.
- Habilitar copias de seguridad diarias.
- Guardar tu APP_KEY de forma segura.
- Probar una copia de seguridad manual.
El self-hosting te da el control. Las copias de seguridad te dan tranquilidad.