Saltar al contenido principal

Actualizaciones y copias de seguridad

Esta guía explica cómo actualizar PlexSub y qué datos debes proteger.

Qué debes conservar​

No borres estos volúmenes salvo que quieras reiniciar la instalación desde cero:

  • plexsub_postgres_data: base de datos.
  • plexsub_backups_data: backups generados por la app.
  • plexsub_uploads_data: logos, branding y archivos subidos.

También debes conservar el .env.

Claves importantes​

El .env contiene valores críticos:

  • POSTGRES_PASSWORD.
  • APP_SETTINGS_ENCRYPTION_KEY.
  • SESSION_SIGNING_SECRET.

La más importante para integraciones es APP_SETTINGS_ENCRYPTION_KEY. Si la pierdes, PlexSub no podrá descifrar secretos ya guardados.

Antes de actualizar​

  1. Revisa la versión actual.
  2. Haz backup de la base de datos.
  3. Guarda copia segura del .env.
  4. Confirma que tienes acceso al servidor.
  5. Lee notas de versión si hay cambios relevantes.

Actualizar con Docker Compose​

Desde la carpeta del docker-compose.yml:

docker compose pull app
docker compose up -d --force-recreate app

En Linux:

docker compose pull app
docker compose up -d --force-recreate app

Qué comprobar después​

  • La app arranca sin reinicios.
  • El panel admin abre.
  • Puedes iniciar sesión.
  • El Customer Portal carga.
  • Los servicios configurados siguen correctos.
  • No hay errores repetidos en logs.

No uses down -v para actualizar​

Este comando borra volúmenes:

docker compose down -v

No lo uses para actualizar.

Backup básico de PostgreSQL​

Ejemplo genérico:

docker compose exec db pg_dump -U plexsub plexsub > plexsub-backup.sql

El usuario y base de datos pueden cambiar según tu .env.

Guarda backups en un lugar seguro. Pueden contener datos personales y configuración privada.

Restauración​

Antes de restaurar en producción:

  • Prueba en una instalación aparte.
  • Usa la misma APP_SETTINGS_ENCRYPTION_KEY.
  • Restaura también uploads si usas branding o archivos subidos.
  • Valida login, portal y servicios.

PostgreSQL y cambios de major​

No cambies de major PostgreSQL sobre el mismo volumen.

Para un cambio mayor:

  1. Backup.
  2. Volumen nuevo.
  3. Restore.
  4. Validación.
  5. Rollback preparado.

Buenas prácticas​

  • Automatiza backups.
  • Prueba restauraciones periódicamente.
  • No guardes backups en repositorios.
  • No compartas backups por canales públicos.
  • Guarda .env cifrado o en un gestor seguro.
  • Documenta la versión que estaba funcionando al hacer backup.