Jellyfin 12 upgrade and migration

Jellyfin 12 es el primer lanzamiento en mucho tiempo que se negará a cargar en un servidor cuyos complementos no se hayan actualizado. El equipo finalmente está limpiando el esquema de la base de datos, endureciendo los contratos de API de complementos y abandonando la compatibilidad con algunos flujos de autenticación antiguos. Eso es saludable para el proyecto. También es una oportunidad real de romper tu servidor doméstico si lo actualizas sin un plan.

Examinamos siete herramientas de escritorio que hacen que la actualización sea segura: una copia de seguridad que realmente se restaura, una auditoría de complementos antes de actualizar, una ruta de reversión si falla la migración y una verificación de metadatos después. Seis de los siete son gratuitos y de código abierto. Todos se ejecutan en Windows, macOS y Linux (o en un contenedor que lo hace).

Qué buscar

Comparación rápida

Aplicación Mejor para Plataformas Plan gratuito Precio Licencia
Jellyfin El servidor en sí Windows, macOS, Linux, Docker Gratuito GPL
Jellyfin Backup Plugin Copia de seguridad de configuración y base de datos en la aplicación Cualquier host de Jellyfin Gratuito GPL
Kopia Copias de seguridad de servidor completamente cifradas Windows, macOS, Linux Gratuito Apache 2.0
Portainer Reversión de contenedor y fijación de imagen Windows, macOS, Linux Gratuito (Community) zlib
Watchtower Actualizaciones controladas de Docker Linux, Docker Gratuito Apache 2.0
Diun Notificación antes de extraer imágenes nuevas Linux, Docker Gratuito MIT
TinyMediaManager Limpieza de metadatos antes o después de la actualización Windows, macOS, Linux Gratuito / ~$50/año Apache 2.0

1. Jellyfin — El servidor en sí, actualizado a tu conveniencia

Jellyfin es el servidor multimedia. Para una actualización de versión 12, el consejo honesto es: no aceptes la actualización automática. Fija la etiqueta 10.x en Docker, detén el contenedor, ejecuta los pasos de copia de seguridad a continuación, y extrae la nueva etiqueta manualmente cuando estés listo para permanecer frente al servidor una hora.

Donde se queda corta: Los hábitos de actualización automática de algunas rutas del instalador (servicio de Windows nativo, algunos paquetes de distro) hacen que fijar sea más difícil de lo que debería ser.

Precio:

Plataformas: Windows, macOS, Linux, Docker, ARM.

Descarga: jellyfin.org.

Conclusión: Fija la etiqueta, toma la copia de seguridad, actualiza deliberadamente.

2. Jellyfin Backup Plugin — Mejor copia de seguridad de configuración y base de datos en la aplicación

Jellyfin Backup Plugin es el complemento oficial de primera entidad que empaqueta el directorio de configuración, la base de datos de metadatos y la base de datos de usuarios en un único zip en un horario. La restauración es un clic. Para el salto de versión 12, ejecuta una copia de seguridad manual con el servidor detenido para que nada esté escribiendo a mitad del camino, luego mantén una copia de seguridad programada en la nueva versión.

Donde se queda corta: No hace una copia de seguridad de la propia biblioteca de medios, solo de los metadatos alrededor de ella. El almacenamiento es local a menos que lo apuntes a un recurso compartido.

Precio:

Plataformas: Cualquier host que ejecute Jellyfin.

Descarga: Instala desde el catálogo de complementos de Jellyfin dentro del Dashboard.

Conclusión: Lo primero que instalar. El que hace que la reversión sea trivial si la actualización sale mal.

3. Kopia — Las mejores copias de seguridad de servidor completamente cifradas

Kopia es la herramienta de copia de seguridad que maneja la capa que el complemento de Jellyfin no puede alcanzar: la carpeta de configuración completa, la caché de arte, el tmp de transcodificación y los archivos de composición. Duplica, cifra y envía a S3, B2, NAS u otro disco. Las instantáneas son incrementales y montables para restaurar.

Donde se queda corta: Curva de aprendizaje para el modelo de repositorio/política. La interfaz gráfica es una pestaña de navegador, no una aplicación nativa.

Precio:

Plataformas: Windows, macOS, Linux.

Descarga: kopia.io.

Conclusión: La capa de copia de seguridad debajo del complemento. Configura una vez, olvida hasta que la necesites.

4. Portainer — Mejor reversión de contenedor y fijación de imagen

Portainer es la interfaz de Docker que hace que fijar una etiqueta de imagen específica de Jellyfin sea unos pocos clics en lugar de una edición de archivo de composición. Duplica el stack, mantén el antiguo pausado con la etiqueta antigua, ejecuta el nuevo lado a lado. Si 12 se comporta mal, detén el nuevo stack, reanuda el antiguo — estás de vuelta en 10.x en menos de un minuto.

Donde se queda corta: El nivel gratuito es generoso pero bloquea algunas características detrás de Business. Los mensajes de inicio de sesión y licencia en cada instalación nueva tardan un minuto en deshabilitarse.

Precio:

Plataformas: Windows, macOS, Linux (Docker).

Descarga: portainer.io.

Conclusión: La red de seguridad. Retrocede a 10.x desde una pestaña del navegador sin tocar la CLI.

5. Watchtower — Mejor control de actualizaciones de Docker

Watchtower actualiza automáticamente los contenedores de Docker cuando llegan nuevas imágenes. Para un servidor doméstico normal, eso es establecer y olvidar. Para la ventana de Jellyfin 12, haz lo opuesto: excluye Jellyfin de la lista de vigilancia de Watchtower para que una actualización programada no te arrastre a la migración a las 3 de la mañana.

Donde se queda corta: Sin interfaz gráfica. La configuración es variables de entorno en el contenedor.

Precio:

Plataformas: Linux (Docker).

Descarga: containrrr.dev/watchtower.

Conclusión: La herramienta para reconfigurar antes de actualizar, para que decidas cuándo se mueve Jellyfin.

6. Diun — Mejor alternativa de “notificar antes de extraer” a Watchtower

Diun vigila los registros de imágenes y te envía un ping (mediante Discord, Telegram, ntfy o correo electrónico) cuando se publica una nueva etiqueta. A diferencia de Watchtower, nunca extrae ni reinicia — simplemente te dice que el mundo se ha movido. Perfecto para la ventana de Jellyfin 12: recibes el ping, decides cuándo actualizar realmente.

Donde se queda corta: No es un actualizador. Si deseas cero intervención, Watchtower es la herramienta.

Precio:

Plataformas: Linux (Docker).

Descarga: github.com/crazy-max/diun.

Conclusión: La herramienta adecuada para cualquiera que desee un empujón sin una extracción automática.

7. TinyMediaManager — Mejor limpieza de metadatos antes o después de la actualización

TinyMediaManager escanea tu biblioteca y reescribe metadatos desordenados en una estructura limpia de nfo + arte que Jellyfin ama. Ejecútalo antes de la actualización para corregir episodios mal etiquetados y arte faltante; ejecútalo de nuevo después para detectar cualquier cosa que el nuevo escáner exponga. El nivel gratuito cubre los casos comunes; la v5 pagada desbloquea acciones masivas.

Donde se queda corta: La versión gratuita limita algunas acciones masivas y características de episodios de TV a la v5 pagada.

Precio:

Plataformas: Windows, macOS, Linux.

Descarga: tinymediamanager.org.

Conclusión: Ejecuta esto una vez al año incluso sin actualización. Alrededor de un salto de Jellyfin 12, ejecútalo antes y después.

Cómo elegir la correcta

Preguntas frecuentes

¿Debo omitir Jellyfin 12 y esperar? No. Esperar no reduce el riesgo, solo lo traslada. Haz una copia de seguridad, fija la etiqueta actual, actualiza primero una instancia de staging, luego actualiza la real.

¿Qué complementos se romperán en Jellyfin 12? El equipo está publicando una lista de compatibilidad en el blog de Jellyfin y en las notas de la versión. Verifica cada complemento de terceros (auto-organizar, transcodificadores personalizados, autenticación personalizada) antes de actualizar.

¿Puedo ejecutar Jellyfin 10.x y 12 uno al lado del otro? Con Docker, sí. Apunta cada contenedor a una carpeta de configuración separada (Jellyfin 12 migrará la base de datos en su lugar, así que no compartas la carpeta de configuración entre versiones).

¿Cuánto tiempo tarda la migración de la base de datos? Para una biblioteca de 5.000 elementos, espera unos pocos minutos en SSD, decenas de minutos en disco giratorio. No detengas el contenedor mientras se ejecuta.

¿Necesito una instalación nueva o funciona la actualización en su lugar? La actualización en su lugar es compatible y se espera para la mayoría de los usuarios. Una instalación nueva es el camino seguro si tu servidor tiene años de quirks de configuración acumulados o complementos de una era más antigua.