Ir al contenido principal

Actualizaciones y Retrocesos

Traducción Beta No Oficial

Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →

Este documento proporciona detalles sobre cómo actualizar y retroceder entre versiones Estable e Inestable, y por qué podrías querer hacerlo.

Estable vs. Inestable​

La elección del tipo de instalación depende de tus necesidades; en esencia, Inestable sirve para probar nuevas funciones, mientras que Estable es para ejecutar un servidor que otros puedan usar con confiabilidad.

  • Estable ofrece la experiencia de usuario más consistente y predecible. Una versión principal específica (ej. 10.8.z, 10.9.z) no introducirá, eliminará ni cambiará funciones principales (con pequeñas excepciones para seguridad). Las correcciones de errores se proporcionan en versiones de punto, liberadas según sea necesario durante el ciclo de vida de la versión principal en respuesta a correcciones y alertas de seguridad. La mayoría de usuarios deberían usar versiones Estables, ya que esto garantiza máxima disponibilidad y consistencia para tus usuarios finales.

  • Inestable ofrece las funciones más actualizadas y vanguardistas, pero puede tener cambios disruptivos rápidos e impredecibles o errores graves, además de soporte limitado para clientes debido a cambios en la API. Las versiones Inestables se proporcionan mediante builds binarias semanales los lunes alrededor de las 5:00 AM UTC, o compilando tus propios paquetes desde la rama de código master.

Además, Inestable se usa para probar próximos lanzamientos durante el ciclo de versiones principales ya que no ofrecemos builds beta. Si quieres ayudarnos a probar futuros lanzamientos -y pedimos que todos quienes puedan lo hagan- necesitarás ejecutar builds Inestables durante algún tiempo antes de volver a Estable tras el lanzamiento.

¿Qué significa "no hay builds beta"?​

Debido a la enorme complejidad de empaquetar Jellyfin para múltiples plataformas únicas, sin mencionar builds de terceros que añaden más, decidimos no ofrecer builds etiquetadas explícitamente como pre-lanzamiento a partir de nuestra versión 10.9.0. Esto es inusual en software libre y de código abierto, pero es una necesidad práctica para agilizar nuestros lanzamientos principales y aumentar su cadencia.

Para compensar, implementamos una congelación de características para cambios disruptivos antes de lanzamientos principales, usando nuestras builds Inestables semanales como alternativa. Antes de cada versión principal, anunciaremos un calendario de próximas builds Inestables y cómo mapearlas a versiones pre-lanzamiento hipotéticas "beta" y "candidata". Por ejemplo, con 4 semanas de congelación, consideraríamos las primeras 3 semanas de builds Inestables como "beta" y la última como "candidata". Si quieres probar temprano, hazlo en las primeras 3 semanas; si prefieres esperar estabilidad, espera hasta la última semana.

Aunque este sistema no es perfecto, simplifica significativamente el versionado, evita un tercer componente/etiqueta en repositorios, y da más visibilidad a las builds Inestables durante lanzamientos, con muy poca carga administrativa adicional frente a versiones pre-lanzamiento explícitas.

Advertencias y Notas​

Haz Copias de Seguridad​

Generalmente, una vez actualizas a una versión Inestable desde una versión Estable, no puedes retroceder simplemente a esa versión Estable original. Esto ocurre porque las versiones Inestables suelen modificar esquemas de bases de datos, entradas de configuración y otros metadatos que la versión Estable anterior no puede manejar.

La única forma de retroceder de Inestable a una versión Estable anterior es restaurar desde una copia de seguridad o borrar completamente tus datos y comenzar de nuevo. La excepción es migrar de Inestable a una nueva versión Estable principal cuando esta se lanza.

Siempre haz una copia de seguridad de los datos y directorios de configuración de tu instancia antes de actualizar a Inestable por cualquier motivo. Nunca sabes qué podría fallar: errores en migraciones, bugs críticos que obliguen a retroceder, o corrupción de datos. Esto aplica incluso para pruebas justo antes de un lanzamiento Estable. Siempre es mejor tener una copia lista, realizar pruebas inmediatas tras actualizar, y revertir si algo falla -¡después de reportar el error, claro está!

Puedes utilizar ciertos complementos para ayudarte con esto, por ejemplo, el complemento Trakt para sincronizar el estado de visualización, pero esto no preservará necesariamente todo. Así que ten cuidado aquí y conoce las limitaciones antes de proceder.

Sigue el proceso detallado en la documentación aquí para obtener más detalles.

Desactivar actualizaciones automáticas en Unstable​

Ejecutar con actualizaciones automáticas mientras estás en Unstable, o durante pruebas previas al lanzamiento de Unstable, puede causar problemas. Siempre asegúrate de actualizar manualmente y probar después. Generalmente recomendamos evitar actualizaciones automáticas incluso en Stable, ya que puede hacer que se pasen por alto las notas de la versión, pero entendemos lo deseable que puede ser; evita la tentación cuando ejecutes Unstable para no perderte cambios importantes.

Actualizar de Stable a Unstable​

Los detalles exactos de este proceso dependen de tu plataforma y método de instalación. Este documento detalla los dos más populares: paquetes Debian/Ubuntu mediante nuestro repositorio, y Docker. El proceso es generalmente el mismo para otros (por ejemplo, descargas manuales, instaladores de Windows, etc.) con los detalles específicos cambiados; para las particularidades de cada plataforma, consulta los artículos hijos en Pruebas del Servidor Jellyfin.

Suponemos que ya estás ejecutando versiones Stable de Jellyfin.

Complementos (Stable a Unstable)​

Proporcionamos complementos para versiones Stable y Unstable en repositorios separados con versionado independiente. Esto evita incompatibilidades accidentales y nos permite lanzar complementos Unstable con mayor rapidez en respuesta a cambios continuos en la rama master. Deberás cambiar al repositorio de complementos Unstable si utilizas algún complemento. Si haces esto antes de actualizar, los complementos se actualizarán automáticamente después.

Los plugins están versionados de modo que las versiones Unstable se actualizarán sin problemas desde la última versión Stable a una versión Unstable, permitiendo luego una transición fluida de la versión Unstable a la siguiente versión Stable (ej: 13.0.0.0 Stable -> 13.2024.0429.0 Unstable -> 14.0.0.0 Stable).

  1. En tu instancia de servidor Jellyfin, navega a Panel de control -> Plugins -> Repositorios.

  2. Elimina el repositorio "Stable" predeterminado haciendo clic en el botón de papelera.

  3. Agrega un nuevo repositorio con el botón "+". Nombra el repositorio como desees y utiliza la siguiente URL:

    https://repo.jellyfin.org/files/plugin-unstable/manifest.json

Repositorios Debian/Ubuntu (Stable a Unstable)​

  1. Edita tu /etc/apt/sources.list.d/jellyfin.sources y añade unstable a la línea Components:. No elimines main, simplemente añade unstable después:

    ...
    Components: main unstable
    ...

  2. Ejecuta sudo apt-get update.

  3. Ejecuta sudo apt-get upgrade y aplica las actualizaciones de paquetes Jellyfin. Jellyfin se reiniciará automáticamente.

  4. Una vez que Jellyfin inicie, si actualizaste tu repositorio de complementos antes de la actualización, los complementos se actualizarán automáticamente a sus versiones Unstable. Espera a que Jellyfin termine de iniciar, luego reinicia el servicio nuevamente (ya sea mediante el botón "Reiniciar" en la interfaz o comandos "systemctl") para completar la actualización.

Docker (Stable a Unstable)​

  1. Detén tu contenedor de Jellyfin.

  2. Descarga la etiqueta de imagen jellyfin/jellyfin:unstable.

  3. Inicia un nuevo contenedor de Jellyfin con la imagen actualizada.

Actualizar de Unstable a Stable al momento del lanzamiento​

Cuando se lanza una nueva versión mayor de Jellyfin, es posible -hasta la siguiente publicación de Unstable- actualizar directamente desde Unstable a la nueva versión Stable. Esto proporciona una ruta de migración para los probadores de Unstable antes del lanzamiento para pasar a la versión Stable definitiva.

Como parte del proceso de lanzamiento, las compilaciones semanales de Unstable se desactivarán temporalmente durante 1-2 semanas para ofrecer una ventana para esta transición, tras lo cual se reanudarán con normalidad. Si deseas permanecer en Unstable, puedes simplemente esperar; de lo contrario, sigue el proceso aquí descrito para "actualizar" a la nueva versión Stable.

Los detalles exactos de este proceso dependen de tu plataforma y método de instalación. Este documento detallará los dos más populares: paquetes Debian/Ubuntu mediante nuestro repositorio, y Docker. El proceso es generalmente similar para otros (por ejemplo, descargas manuales, instaladores de Windows, etc.) con los detalles específicos adaptados; para conocer las particularidades de cada plataforma, consulta los artículos secundarios bajo "Pruebas del Servidor Jellyfin".

Asumimos que ya estás ejecutando versiones Inestables (Unstable) de Jellyfin.

Plugins (De Unstable a Release)​

Proporcionamos plugins para versiones Stable y Unstable en repositorios separados con versionado independiente. Deberás cambiar (volver) al repositorio de plugins Stable si utilizas algún plugin, para evitar instalar versiones incompatibles futuras de plugins Unstable en tu instalación Stable. Ten en cuenta que los plugins podrían no estar disponibles durante algunas horas o días después de un nuevo lanzamiento, dependiendo del plugin; si ya están preparados y sigues estos pasos, deberían actualizarse automáticamente al volver a Stable.

Los plugins están versionados de modo que las versiones Unstable se actualizarán sin problemas desde la última versión Stable a una versión Unstable, permitiendo luego una transición fluida de la versión Unstable a la siguiente versión Stable (ej: 13.0.0.0 Stable -> 13.2024.0429.0 Unstable -> 14.0.0.0 Stable).

  1. En tu instancia de servidor Jellyfin, navega a Panel de control -> Plugins -> Repositorios.

  2. Elimina el repositorio "Unstable" haciendo clic en el botón de papelera.

  3. Añade un nuevo repositorio con el botón "+". Nombra el repositorio como desees ("Stable" es el predeterminado) y utiliza la siguiente URL:

    https://repo.jellyfin.org/files/plugin/manifest.json

Debian/Ubuntu (De Unstable a Release)​

  1. Edita tu archivo /etc/apt/sources.list.d/jellyfin.sources y elimina unstable de la línea Components::

    ...
    Components: main
    ...

  2. Ejecuta sudo apt-get update.

  3. Ejecuta sudo apt install jellyfin=<version> jellyfin-server=<version> jellyfin-web=<version>. Reemplaza <version> con el número de versión deseado, por ejemplo 10.9.1+ubu2204. Esto reinstalará la versión Stable sobre la versión Unstable. Jellyfin se reiniciará automáticamente.

    Ejemplo: sudo apt install jellyfin=10.9.1+ubu2204 jellyfin-server=10.9.1+ubu2204 jellyfin-web=10.9.1+ubu2204

Docker (De Unstable a Release)​

  1. Detén tu contenedor de Jellyfin.

  2. Descarga la etiqueta de imagen jellyfin/jellyfin:latest.

  3. Inicia un nuevo contenedor de Jellyfin con la imagen actualizada.

Post-instalación (De Unstable a Release)​

  1. Una vez disponibles las actualizaciones de plugins, Jellyfin debería actualizarlos automáticamente a la siguiente versión estable como se mencionó anteriormente. Si encuentras alguno que no se actualice, intenta actualizarlo manualmente.

Revertir de Unstable a una versión Stable anterior​

Como se mencionó anteriormente, este proceso requiere restaurar desde una copia de seguridad realizada antes de actualizar a Unstable por primera vez.

Los detalles exactos de este proceso dependen de tu plataforma y método de instalación. Este documento detalla los dos más populares: paquetes Debian/Ubuntu mediante nuestro repositorio, y Docker. El proceso es generalmente el mismo para otros (por ejemplo, descargas manuales, instaladores de Windows, etc.) con los detalles específicos cambiados; para las particularidades de cada plataforma, consulta los artículos hijos en Pruebas del Servidor Jellyfin.

Asumimos que ya estás ejecutando versiones Inestables (Unstable) de Jellyfin.

Debian/Ubuntu (De Inestable a Estable Anterior)​

  1. Detén Jellyfin usando el gestor de servicios (sudo service jellyfin stop o similar). Asegúrate de que Jellyfin se haya detenido realmente.

  2. Restaura tu copia de seguridad de los directorios de configuración y datos. Asegúrate de eliminar completamente el contenido actual (o moverlo a otro lugar) primero.

  3. Edita tu archivo /etc/apt/sources.list.d/jellyfin.sources y elimina unstable de la línea Components:.

    ...
    Components: main
    ...

  4. Ejecuta sudo apt-get update.

  5. Ejecuta sudo apt-get install --reinstall jellyfin jellyfin-server jellyfin-web. Esto reinstalará forzosamente la nueva versión Estable sobre la versión Inestable. Jellyfin debería iniciar automáticamente; si no, inícialo usando el gestor de servicios (sudo service jellyfin start o similar).

Docker (De Inestable a Estable Anterior)​

  1. Detén tu contenedor de Jellyfin.

  2. Restaura tu copia de seguridad de los directorios de configuración y datos. Asegúrate de eliminar completamente el contenido actual (o moverlo a otro lugar) primero.

  3. Descarga la etiqueta de imagen jellyfin/jellyfin:latest.

  4. Inicia un nuevo contenedor de Jellyfin con la imagen actualizada.

Post-instalación (De Inestable a Estable Anterior)​

  1. Tu copia de seguridad debería haber restaurado tu repositorio original de plugins y sus versiones. Si no es así, es posible que necesites eliminar cualquier plugin Inestable y reinstalarlos; la configuración se preservará aquí.