Hands-on Lab

Actualizar Jellyfin de 10.11 a 12 en Docker con copia y vuelta atrás

21 de octubre de 2026 3 min

0 / 9

Chuleta

¿Te ha servido? No te pierdas el próximo lab

El vídeo tiene subtítulos y transcripción. Todo lo que se ve está escrito, paso a paso, más abajo. Chuleta con todos los comandos

0:00 / 0:00

Creamos compose.yaml con la etiqueta jellyfin/jellyfin:10.11.11 fijada y el usuario 1000:1000 para no ejecutar como root. Publicamos el puerto 8096 de la web y la API, y montamos la biblioteca de /srv/media en solo lectura. La configuración y la base de datos viven en el volumen jellyfin-config: es lo único que hay que copiar antes de actualizar.

mkdir -p ~/jellyfin /srv/media && cd ~/jellyfin && cat > compose.yaml <<'EOF'
services:
  jellyfin:
    image: jellyfin/jellyfin:10.11.11
    container_name: jellyfin
    user: 1000:1000
    ports:
      - "8096:8096/tcp"
      - "7359:7359/udp"
    volumes:
      - jellyfin-config:/config
      - jellyfin-cache:/cache
      - type: bind
        source: /srv/media
        target: /media
        read_only: true
    restart: unless-stopped
volumes:
  jellyfin-config:
    name: jellyfin-config
  jellyfin-cache:
    name: jellyfin-cache
EOF
echo "compose.yaml written: $(wc -l < compose.yaml) lines"

Lo hice yo

Comprobamos que Compose interpreta el fichero sin errores y que la imagen y los dos volúmenes son los que esperamos antes de arrancar nada.

cd ~/jellyfin && docker compose config --images && docker compose config --volumes

Qué demuestra

jellyfin/jellyfin:10.11.11 la imagen fijada es la 10.11.11 Objetivo · partes de la versión que el salto a la 12.0 admite
jellyfin-config existe un volumen con nombre para /config Objetivo · sabes qué volumen tienes que copiar antes de actualizar

docker compose up -d descarga la imagen y arranca el contenedor en segundo plano. El bucle revisa el registro cada 2 s, hasta 60 veces, hasta ver Startup complete, y después exige que /System/Info/Public conteste sin error. Guardamos el Id del servidor, que vive en el volumen de configuración, para demostrar después que la 12.0 arranca sobre los mismos datos.

cd ~/jellyfin && docker compose up -d --quiet-pull && for i in $(seq 1 60); do docker compose logs jellyfin | grep -q 'Startup complete' && break; sleep 2; done; curl -sf http://localhost:8096/System/Info/Public >/dev/null && echo "Startup complete, API answering (attempt $i)" && curl -s http://localhost:8096/System/Info/Public | jq -r .Id > server-id.txt

Lo hice yo

Leemos la versión real con curl y jq desde /System/Info/Public, que no pide autenticación. Es la comprobación que pide la guía antes de actualizar: el salto directo a la 12.0 solo está admitido desde la 10.10.7 o cualquier 10.11.x.

curl -s http://localhost:8096/System/Info/Public | jq -r '"product: \(.ProductName)", "version: \(.Version)"'

Qué demuestra

version: 10.11.11 el servidor en marcha es la 10.11.11 Objetivo · confirmas desde la API que puedes saltar directo a la 12.0

Primero paramos el servicio para que la base de datos no cambie durante la copia. Después, un contenedor alpine:3 con --rm monta jellyfin-config en solo lectura (:ro) y la carpeta actual en /backup, y tar escribe jellyfin-config.tar.gz. Es la orden de la guía para volúmenes con nombre.

cd ~/jellyfin && docker compose stop jellyfin && docker run --rm -v jellyfin-config:/config:ro -v "$PWD":/backup alpine:3 tar -czf /backup/jellyfin-config.tar.gz -C / config

Lo hice yo

Comprobamos que Jellyfin quedó parado durante la copia. El archivo lleva lo que importa: la base de datos config/data/jellyfin.db, que la 12.0 va a reescribir, y la configuración del servidor en system.xml.

cd ~/jellyfin && docker compose ps -a --format '{{.Name}} {{.State}}' && ls -lh jellyfin-config.tar.gz | awk '{print $5, $9}' && tar -tzf jellyfin-config.tar.gz | grep -E 'jellyfin.db$|system.xml$'

Qué demuestra

jellyfin exited el contenedor estaba parado al hacer la copia Objetivo · sabes que la copia es coherente y sirve para volver
config/data/jellyfin.db la base de datos está dentro del tar.gz Objetivo · tienes a salvo justo lo que la migración va a cambiar

Fijamos 12.0 y no latest, para que una futura 13.0 no llegue sin copia previa. docker compose pull descarga la imagen antes de parar nada más, así que el tiempo de descarga no cuenta como tiempo sin servicio.

cd ~/jellyfin && sed -i 's#jellyfin/jellyfin:10.11.11#jellyfin/jellyfin:12.0#' compose.yaml && docker compose pull --quiet jellyfin && echo pulled

Lo hice yo

Comprobamos el cambio en el fichero y que tenemos las dos imágenes descargadas. Conservar la 10.11.11 en local es parte del plan de vuelta atrás.

cd ~/jellyfin && grep 'image:' compose.yaml && docker image ls jellyfin/jellyfin --format '{{.Repository}}:{{.Tag}}'

Qué demuestra

image: jellyfin/jellyfin:12.0 el servicio usa ya la etiqueta 12.0 Objetivo · el siguiente arranque será el de la versión nueva
jellyfin/jellyfin:10.11.11 la imagen anterior sigue en local Objetivo · puedes volver a la 10.11.11 sin descargar nada

docker compose run --rm arranca un contenedor efímero con la imagen 12.0 sobre el mismo volumen y le pasa --mode MigrateSystem. Filtramos con grep las líneas que importan: cuántas migraciones hay por etapa y si se aplicaron. El paso es opcional, porque el servidor migra solo al arrancar, pero así el resultado no se pierde entre el resto del registro.

cd ~/jellyfin && docker compose run --rm jellyfin --mode MigrateSystem 2>&1 | grep -E 'migrations for stage|Migrations have been|FTL' | sed 's/Jellyfin.Server.Migrations.//'

Lo hice yo

Como MigrateSystem sale con código 0 aunque falle, leemos el registro que Jellyfin dejó en /config/log, montado en solo lectura desde otro contenedor alpine. La frase Migrations have been applied y cero líneas FTL son la señal de que la base de datos ya está en el formato de la 12.0.

docker run --rm -v jellyfin-config:/config:ro alpine:3 sh -c 'grep -ho "Migrations have been applied" /config/log/*.log | tail -1; echo "FTL lines: $(cat /config/log/*.log | grep -c "\[FTL\]")"'

Qué demuestra

Migrations have been applied las migraciones terminaron Objetivo · sabes que la base de datos ya está en el formato nuevo
FTL lines: 0 el registro no tiene errores fatales Objetivo · descartas una migración fallida antes de arrancar el servidor

Compose recrea el contenedor con la imagen 12.0 sobre el volumen ya migrado. La señal de que está listo no es que el contenedor figure como Up, sino la línea Startup complete del registro seguida de una respuesta correcta de /System/Info/Public, que curl -f comprueba.

cd ~/jellyfin && docker compose up -d && for i in $(seq 1 60); do docker compose logs jellyfin | grep -q 'Startup complete' && break; sleep 2; done; curl -sf http://localhost:8096/System/Info/Public >/dev/null && echo "Startup complete, API answering (attempt $i)"

Lo hice yo

Leemos la versión del mismo endpoint que antes y comparamos el Id del servidor con el que guardamos en la 10.11.11. Que coincida demuestra que la 12.0 arrancó sobre la configuración migrada y no sobre un servidor nuevo. /health completa la prueba.

cd ~/jellyfin && curl -s http://localhost:8096/System/Info/Public | jq -r --arg id "$(cat server-id.txt)" '"version: \(.Version)", "same server Id: \(.Id == $id)"' && echo "health: $(curl -s http://localhost:8096/health)"

Qué demuestra

version: 12.0.0 el servidor se identifica como 12.0.0 Objetivo · demuestras la actualización con la API, sin abrir el navegador
same server Id: true el Id coincide con el de la 10.11.11 Objetivo · sabes que la 12.0 usa tus datos de siempre
health: Healthy el endpoint de salud responde Healthy Objetivo · el servidor está listo para el escaneo completo de bibliotecas

Cambiamos la etiqueta de vuelta a 10.11.11 y recreamos el contenedor sobre el volumen que la 12.0 ya migró. Esperamos a la línea Startup complete del registro, con el mismo límite de 60 intentos, para ver qué hace el servidor antiguo con datos nuevos.

cd ~/jellyfin && sed -i 's#jellyfin/jellyfin:12.0#jellyfin/jellyfin:10.11.11#' compose.yaml && docker compose up -d && for i in $(seq 1 60); do docker compose logs jellyfin | grep -q 'Startup complete' && break; sleep 2; done; echo "Startup complete on attempt $i"

Lo hice yo

Un monitor que solo mire /health o el estado del contenedor diría que todo va bien. El registro cuenta otra cosa: [FTL] An error occurred starting the application, porque la 10.11.11 no encuentra en la base de datos el esquema que espera. Este es el motivo de hacer la copia con el servidor parado.

cd ~/jellyfin && curl -s http://localhost:8096/System/Info/Public | jq -r '"version: \(.Version)"' && echo "health: $(curl -s http://localhost:8096/health)" && docker compose logs --no-log-prefix jellyfin | grep -m1 '\[FTL\]' | cut -d' ' -f2,4-

Qué demuestra

health: Healthy el endpoint de salud sigue respondiendo Healthy Objetivo · entiendes por qué un monitor de salud no detecta este fallo
An error occurred starting the application el registro tiene un error fatal de arranque Objetivo · sabes que cambiar solo la etiqueta no es una vuelta atrás

docker compose down quita el contenedor pero conserva los volúmenes con nombre. El contenedor alpine monta jellyfin-config con escritura, borra los datos migrados y extrae la copia en su sitio. La etiqueta ya es 10.11.11, así que el siguiente up arranca la versión anterior sobre los datos anteriores.

cd ~/jellyfin && docker compose down && docker run --rm -v jellyfin-config:/config -v "$PWD":/backup alpine:3 sh -c 'rm -rf /config/* && tar -xzf /backup/jellyfin-config.tar.gz -C /' && docker compose up -d && for i in $(seq 1 60); do docker compose logs jellyfin | grep -q 'Startup complete' && break; sleep 2; done; echo "Startup complete on attempt $i"

Lo hice yo

Comprobamos la versión, que el Id sigue siendo el original y que el registro del nuevo contenedor no tiene ninguna línea FTL. Con la copia restaurada, la 10.11.11 arranca limpia: esa es la vuelta atrás que funciona.

cd ~/jellyfin && curl -s http://localhost:8096/System/Info/Public | jq -r --arg id "$(cat server-id.txt)" '"version: \(.Version)", "same server Id: \(.Id == $id)"' && echo "FTL lines: $(docker compose logs jellyfin | grep -c '\[FTL\]')"

Qué demuestra

version: 10.11.11 el servidor ha vuelto a la 10.11.11 Objetivo · tienes una vuelta atrás probada, no supuesta
FTL lines: 0 el arranque no tiene errores fatales Objetivo · distingues una restauración buena del falso sano del paso anterior

Con -v, docker compose down también elimina los volúmenes con nombre declarados en el compose. En un servidor real no lo harías: aquí el laboratorio es desechable y no queremos dejar datos atrás.

cd ~/jellyfin && docker compose down -v

Lo hice yo

Contamos los contenedores y volúmenes cuyo nombre contiene jellyfin. Los dos contadores a cero confirman que el laboratorio no deja nada.

echo "jellyfin containers: $(docker ps -aq --filter name=jellyfin | wc -l)"; echo "jellyfin volumes: $(docker volume ls -q --filter name=jellyfin | wc -l)"

Qué demuestra

jellyfin containers: 0 no queda ningún contenedor Objetivo · dejas la máquina como estaba
jellyfin volumes: 0 no queda ningún volumen Objetivo · no quedan datos del laboratorio ocupando disco

¿Te ha sido útil este lab? Puntúalo:

Click to rate this post!

[Total: 0 Average: 0]

Transcripción del vídeo

0:00 De Jellyfin 10.11 a 12.0 en Docker, con vuelta atrás.
0:06 Escribimos el compose de la guía con Jellyfin 10.11.11 fijada y dos volúmenes
0:11 con nombre, para la configuración y la caché.
0:16 Jellyfin de la 10.11.11 a la 12.0 en Docker, con copia y vuelta atrás probada.
0:23 La 12.0 reescribe la base de datos en el primer arranque, y la 10.11 ya no puede
0:28 leerla.
0:30 Versión, copia, etiqueta, migración, prueba y restauración.
0:36 Compose valida el fichero:
0:38 imagen 10.11.11 y volúmenes jellyfin-config y jellyfin-cache.
0:45 Levantamos la 10.11.11, esperamos a Startup complete y a la API, y guardamos
0:51 el identificador del servidor para compararlo después.
0:55 La API pública responde sin iniciar sesión:
0:59 versión 10.11.11, un punto de partida admitido.
1:03 La copia que sirve para volver es la de ficheros, hecha con el servidor parado.
1:09 Paramos Jellyfin y un contenedor alpine de usar y tirar empaqueta el volumen de
1:14 configuración en un tar.gz.
1:17 El contenedor está parado y la copia contiene la base de datos de Jellyfin y su
1:22 fichero de configuración del sistema.
1:26 Cambiamos la etiqueta de la imagen de 10.11.11 a 12.0 con sed y descargamos la
1:32 imagen nueva.
1:34 El compose apunta a la 12.0 y conservamos en local la 10.11.11 para volver.
1:43 MigrateSystem aplica las migraciones y sale, sin arrancar el servidor.
1:49 Lanzamos solo la migración:
1:51 18 migraciones de CoreInitialisation, 13 de AppInitialisation, y el registro dice
1:57 que se han aplicado.
1:59 El registro del volumen confirma la migración, con cero líneas FTL.
2:08 Arrancamos la 12.0 y esperamos, con el mismo bucle, a Startup complete y a la
2:13 API.
2:15 La misma consulta devuelve ahora la 12.0.0, con el mismo identificador de
2:20 servidor, y la salud dice Healthy.
2:25 Cambiar solo la etiqueta no basta:
2:27 la 10.11.11 no lee la base de datos migrada.
2:32 Probamos el error que describe la guía:
2:34 volver a la etiqueta 10.11.11 sin restaurar la copia.
2:39 El peligro:
2:40 la API dice 10.11.11 y la salud, Healthy, pero el registro tiene un error
2:46 fatal de arranque.
2:49 La vuelta atrás buena:
2:50 bajamos el servicio, restauramos el tar.gz en el volumen con alpine y
2:56 arrancamos la 10.11.11.
3:00 La 10.11.11 vuelve con el mismo identificador y cero líneas FTL.
3:09 docker compose down con -v borra el contenedor y los volúmenes.
3:16 No queda ningún contenedor ni volumen de Jellyfin.

Este laboratorio reproduce en una máquina desechable la guía cómo actualizar Jellyfin 12 con Docker y poder volver atrás: partes de la 10.11.11 instalada como en la guía para instalar Jellyfin con Docker, copias el volumen de configuración, saltas a la 12.0 y compruebas la vuelta atrás. Todo lo que ves en la terminal se ejecutó de verdad, con las imágenes oficiales jellyfin/jellyfin:10.11.11 y jellyfin/jellyfin:12.0.

Por qué hay que copiar /config antes de actualizar Jellyfin 12

La 12.0 reescribe la base de datos en el primer arranque y la documentación de copia y restauración de Jellyfin lo deja claro: no hay mecanismo para volver a una versión anterior. En la imagen oficial, datos y configuración viven juntos bajo /config, así que esa carpeta es lo único que necesitas guardar. Las notas de la versión 12.0 solo admiten el salto directo desde la 10.10.7 o cualquier 10.11.x.

Cómo se hace la copia de un volumen con nombre

Con Jellyfin parado, un contenedor alpine:3 de usar y tirar monta el volumen jellyfin-config en solo lectura y lo empaqueta con tar. Es el mismo patrón que el laboratorio de copia de seguridad y restauración de volúmenes en Docker, y la diferencia entre volúmenes y carpetas montadas la explica el artículo sobre volúmenes y bind mounts en Docker. La documentación de Docker sobre volúmenes describe la misma técnica.

Qué demuestra la vuelta atrás del laboratorio

Volver a la etiqueta 10.11.11 sin restaurar la copia deja un servidor que contesta Healthy en /health y da su versión por la API, pero cuyo registro tiene un error fatal al arrancar. Restaurar el tar.gz y arrancar la 10.11.11 devuelve un registro sin líneas FTL y el mismo identificador de servidor. Si tienes Jellyfin con la etiqueta latest, revisa también el artículo sobre Watchtower para actualizar contenedores Docker: la imagen oficial en Docker Hub mueve latest a la 12.0, y una actualización automática migra sin copia previa.

El laboratorio no cubre el escaneo completo de bibliotecas ni los complementos de terceros, porque la máquina no tiene biblioteca ni usuarios. Esos pasos, con sus tiempos medidos, están en la guía escrita.

Preguntas frecuentes

¿Puedo volver a Jellyfin 10.11 solo cambiando la etiqueta de la imagen?

No. En este lab, la 10.11.11 arrancada sobre datos ya migrados respondió Healthy en /health y dio la versión por la API, pero su registro tenía un error fatal al arrancar la aplicación. Hay que restaurar la copia de /config hecha antes de migrar.

¿Cómo compruebo la versión de Jellyfin sin iniciar sesión?

Consulta /System/Info/Public, que no pide autenticación: curl -s http://localhost:8096/System/Info/Public | jq -r .Version. En el lab devolvió 10.11.11 antes de actualizar y 12.0.0 después.

¿Cómo hago la copia de seguridad si uso volúmenes con nombre?

Para Jellyfin y monta el volumen en un contenedor auxiliar: docker run –rm -v jellyfin-config:/config:ro -v "$PWD":/backup alpine:3 tar -czf /backup/jellyfin-config.tar.gz -C / config. La restauración es la misma idea al revés, con el volumen montado con escritura.

¿Hace falta ejecutar –mode MigrateSystem antes de arrancar la 12.0?

No, el servidor migra solo al arrancar. Separarlo te deja leer el resultado: en el lab anunció 18 migraciones de CoreInitialisation y 13 de AppInitialisation. Como sale con código 0 aunque falle, revisa que el registro diga Migrations have been applied y no tenga líneas FTL.

Chuleta

mkdir -p ~/jellyfin /srv/media && cd ~/jellyfin && cat > compose.yaml <<'EOF'
services:
  jellyfin:
    image: jellyfin/jellyfin:10.11.11
    container_name: jellyfin
    user: 1000:1000
    ports:
      - "8096:8096/tcp"
      - "7359:7359/udp"
    volumes:
      - jellyfin-config:/config
      - jellyfin-cache:/cache
      - type: bind
        source: /srv/media
        target: /media
        read_only: true
    restart: unless-stopped
volumes:
  jellyfin-config:
    name: jellyfin-config
  jellyfin-cache:
    name: jellyfin-cache
EOF
echo "compose.yaml written: $(wc -l < compose.yaml) lines"

cd ~/jellyfin && docker compose up -d --quiet-pull && for i in $(seq 1 60); do docker compose logs jellyfin | grep -q 'Startup complete' && break; sleep 2; done; curl -sf http://localhost:8096/System/Info/Public >/dev/null && echo "Startup complete, API answering (attempt $i)" && curl -s http://localhost:8096/System/Info/Public | jq -r .Id > server-id.txt

cd ~/jellyfin && docker compose stop jellyfin && docker run --rm -v jellyfin-config:/config:ro -v "$PWD":/backup alpine:3 tar -czf /backup/jellyfin-config.tar.gz -C / config

cd ~/jellyfin && sed -i 's#jellyfin/jellyfin:10.11.11#jellyfin/jellyfin:12.0#' compose.yaml && docker compose pull --quiet jellyfin && echo pulled

cd ~/jellyfin && docker compose run --rm jellyfin --mode MigrateSystem 2>&1 | grep -E 'migrations for stage|Migrations have been|FTL' | sed 's/Jellyfin.Server.Migrations.//'

cd ~/jellyfin && docker compose up -d && for i in $(seq 1 60); do docker compose logs jellyfin | grep -q 'Startup complete' && break; sleep 2; done; curl -sf http://localhost:8096/System/Info/Public >/dev/null && echo "Startup complete, API answering (attempt $i)"

cd ~/jellyfin && sed -i 's#jellyfin/jellyfin:12.0#jellyfin/jellyfin:10.11.11#' compose.yaml && docker compose up -d && for i in $(seq 1 60); do docker compose logs jellyfin | grep -q 'Startup complete' && break; sleep 2; done; echo "Startup complete on attempt $i"

cd ~/jellyfin && docker compose down && docker run --rm -v jellyfin-config:/config -v "$PWD":/backup alpine:3 sh -c 'rm -rf /config/* && tar -xzf /backup/jellyfin-config.tar.gz -C /' && docker compose up -d && for i in $(seq 1 60); do docker compose logs jellyfin | grep -q 'Startup complete' && break; sleep 2; done; echo "Startup complete on attempt $i"

```
cd ~/jellyfin && docker compose down -v
```

¿Te ha servido? No te pierdas el próximo lab

Suscríbete a la newsletter

Por qué hay que copiar /config antes de actualizar Jellyfin 12

Cómo se hace la copia de un volumen con nombre

Qué demuestra la vuelta atrás del laboratorio

Preguntas frecuentes

¿Puedo volver a Jellyfin 10.11 solo cambiando la etiqueta de la imagen?

¿Cómo compruebo la versión de Jellyfin sin iniciar sesión?

¿Cómo hago la copia de seguridad si uso volúmenes con nombre?

¿Hace falta ejecutar –mode MigrateSystem antes de arrancar la 12.0?

Chuleta