Saltar al contenido principal

Actualizar y migrar versiones

Estado de versiones

Según versions.txt:

  • Stable/latest actual: 0.65.0.
  • Línea activa de desarrollo: 0.65.1.
  • El repositorio indica PostgreSQL por defecto postgres:18.4-alpine.

No confundas la línea de desarrollo con una promoción estable. Una versión no está publicada como stable/latest hasta que exista una entrada explícita de promoción.

Antes de actualizar

  1. Lee versions.txt o el changelog publicado.
  2. Revisa si hay cambios de base de datos.
  3. Revisa si cambia la imagen de PostgreSQL.
  4. Haz backup.
  5. Guarda .env y secretos.
  6. Prueba restauración si el cambio es importante.

Actualización normal con Docker Compose

  1. Fija la nueva imagen en .env.
  2. Descarga imágenes.
  3. Levanta la pila.
  4. Revisa salud de contenedores.
  5. Entra en PlexSub y valida pantallas principales.

Comandos habituales:

docker compose pull docker compose up -d docker compose ps

PostgreSQL

No actualices una versión mayor de PostgreSQL recreando el contenedor sobre el volumen viejo.

Si el cambio implica versión mayor:

  1. Haz dump.
  2. Crea volumen nuevo.
  3. Restaura en la versión nueva.
  4. Valida arranque.
  5. Conserva el backup hasta confirmar estabilidad.

Rollback

Un rollback seguro requiere:

  • Imagen anterior conocida.
  • Backup compatible.
  • .env anterior.
  • Conocimiento de si hubo migraciones de base de datos.

No asumas que puedes bajar versión sin restaurar backup. Si una migración cambió esquema o datos, volver a una imagen anterior puede fallar.

Validación después de actualizar

Comprueba:

  • Login admin.
  • Portal de cliente.
  • Servicios configurados.
  • Tareas programadas.
  • Envío de correo si lo usas.
  • Peticiones si usas Seerr o Peticiones nativas.
  • Historial/uso si usas Tautulli, Tracearr o Jellystat.
  • Backups posteriores a la actualización.