Docker: Jellyfin - para qué sirve y cómo instalarlo

Publicado por Curso Docker

Logo de Jellyfin

Imagen Docker del curso, nº 2. Jellyfin es un servidor multimedia libre: organiza tus películas, series, música y fotos y te las ofrece en streaming a la tele, el móvil o el navegador, sin suscripciones.

¿Para qué sirve?

  • Montar tu propia plataforma de streaming con tus archivos.
  • Ver tu biblioteca desde cualquier dispositivo de casa.

Instalación con docker run

Este es el comando del README oficial (cambia las rutas /path/to/... por carpetas de tu equipo):

docker run -d \
  --name=jellyfin \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e JELLYFIN_PublishedServerUrl=http://192.168.0.5 `#optional` \
  -p 8096:8096 \
  -p 8920:8920 `#optional` \
  -p 7359:7359/udp `#optional` \
  -p 1900:1900/udp `#optional` \
  -v /path/to/jellyfin/library:/config \
  -v /path/to/tvseries:/data/tvshows \
  -v /path/to/movies:/data/movies \
  --restart unless-stopped \
  lscr.io/linuxserver/jellyfin:latest

Instalación con Docker Compose

Ejemplo de docker-compose.yml del README oficial. Guárdalo como docker-compose.yml y ejecuta docker compose up -d:

services:
  jellyfin:
    image: lscr.io/linuxserver/jellyfin:latest
    container_name: jellyfin
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - JELLYFIN_PublishedServerUrl=http://192.168.0.5 #optional
    volumes:
      - /path/to/jellyfin/library:/config
      - /path/to/tvseries:/data/tvshows
      - /path/to/movies:/data/movies
    ports:
      - 8096:8096
      - 8920:8920 #optional
      - 7359:7359/udp #optional
      - 1900:1900/udp #optional
    restart: unless-stopped

Lo más útil del README

  • La interfaz web está en http://TU-IP:8096.
  • El README documenta la aceleración por hardware (por ejemplo, montar /dev/dri para Intel/AMD) si quieres transcodificar con GPU.
  • Documentación oficial: https://jellyfin.org/docs/general/quick-start.html

Consejos

  • Sustituye siempre las rutas de ejemplo por carpetas reales de tu equipo.
  • Comprueba que el contenedor está activo con docker ps y revisa los logs con docker logs NOMBRE.
  • Cambia las contraseñas por defecto antes de exponer el servicio fuera de tu red.

Antes de empezar con Jellyfin

Necesitas un equipo con Docker instalado y funcionando. Comprueba la versión con docker --version y la de Compose con docker compose version. Si tu usuario no está en el grupo docker, tendrás que anteponer sudo a los comandos. Mira también que los puertos 8096, 8920, 7359, 1900 estén libres con ss -tulpn | grep 8096: si otro servicio usa alguno, el contenedor no arrancará y tendrás que elegir otro puerto en la parte izquierda de la asignación.

Cómo comprobar que Jellyfin funciona

Después de arrancar el contenedor, ejecuta docker ps y busca jellyfin en la lista con estado Up. Si aparece reiniciándose o desaparece al poco rato, lee el motivo con docker logs -f jellyfin; casi siempre es una ruta mal escrita o un permiso. Cuando esté estable, si la aplicación tiene interfaz web, ábrela en el navegador con la dirección y el puerto que indica el README oficial. Dale un minuto en el primer arranque, porque algunas aplicaciones preparan su base de datos antes de aceptar conexiones.

Dónde se guardan los datos

En el ejemplo se montan estas rutas: /path/to/jellyfin/library:/config, /path/to/tvseries:/data/tvshows, /path/to/movies:/data/movies. La parte de la izquierda es la carpeta de tu equipo y la de la derecha es la ruta dentro del contenedor. Todo lo que quieras conservar debe estar en una carpeta montada, porque lo que queda dentro del contenedor se pierde si lo eliminas. Crea las carpetas antes de arrancar, con el usuario que vaya a usarlas, para evitar errores de permisos.

Cómo actualizar Jellyfin

Para actualizar con Compose, ve a la carpeta del docker-compose.yml y ejecuta docker compose pull seguido de docker compose up -d. Docker descarga la imagen nueva y recrea el contenedor sin tocar tus carpetas montadas. Después puedes limpiar imágenes viejas con docker image prune.

Copia de seguridad de Jellyfin

Antes de actualizar o cambiar nada, copia las carpetas que montaste. Lo más seguro es parar el contenedor con docker stop jellyfin, comprimir la carpeta con tar czf copia-jellyfin.tar.gz /ruta/a/tu/carpeta y volver a arrancarlo con docker start jellyfin. Guarda la copia en otro disco o en otro equipo, y prueba a restaurarla de vez en cuando: una copia que nunca has probado no es una garantía.

Fuentes: README en GitHub · Docker Hub

Te puede interesar

Comentarios

Publicar un comentario

Entradas populares de este blog

Cómo instalar Hermes Agent en Docker y conectarlo con tu suscripción de Antigravity

Imagen
Entrada especial del blog: Hermes Agent es un agente de inteligencia artificial de código abierto creado por Nous Research, el equipo que está detrás de los modelos Hermes. No es un simple chatbot: puede trabajar de forma autónoma, recuerda lo que ha hecho en tus proyectos y puede seguir funcionando aunque tu ordenador esté apagado. En esta entrada vamos a ver para qué sirve, cómo instalarlo en Docker con docker run y con Docker Compose, y cómo conectarlo con una suscripción de Google Antigravity para aprovechar sus modelos sin pagar nada más. ¿Para qué sirve Hermes Agent? Automatizar tareas de forma autónoma: investigar, programar, escribir y ejecutar acciones por ti sin supervisión constante. Recordar tus proyectos: guarda una memoria persistente de lo que ha hecho y crea sus propias habilidades con el uso. Atenderte por mensajería: lo controlas desde Telegram, Discord, Slack o WhatsApp, y también desde el terminal. ...
Leer más

Docker: OpenBao - para qué sirve y cómo instalarlo

Imagen
OpenBao es un gestor de secretos y cifrado de código abierto: un único sitio seguro donde guardar contraseñas, claves de API, tokens y certificados en lugar de tenerlos repartidos por archivos de configuración y código. Nació como fork comunitario de HashiCorp Vault y hoy lo gobierna la Linux Foundation Edge, así que es una alternativa totalmente libre y sin licencias de pago. La imagen oficial openbao/openbao está en Docker Hub y permite tenerlo funcionando en un servidor o NAS en unos minutos. ¿Para qué sirve? Centralizar secretos (contraseñas, tokens, claves de API, certificados) en un almacén cifrado y dejar de tenerlos en archivos .env o en el código. Controlar quién accede a cada secreto mediante tokens y políticas, con registro de auditoría de cada acceso. Cifrar datos y generar credenciales temporales para bases de datos y servicios en la nube. Instalación con docker run Para una prueba rápida, el contenedor arranca en modo desarrollo si no le pasas nada más. Est...
Leer más

Cómo funciona Docker Compose

Lección 7 del curso de Docker. Cómo funciona Docker Compose Las aplicaciones reales rara vez son un solo contenedor: suelen combinar una aplicación, una base de datos, una caché... Arrancar cada pieza a mano con docker run es tedioso y propenso a errores. Docker Compose resuelve esto: describes toda la aplicación en un solo archivo YAML y la levantas entera con un único comando. El archivo docker-compose.yml Compose se define en un archivo llamado docker-compose.yml (o compose.yaml ) en la raíz del proyecto. En él declaras los servicios (los contenedores), las redes y los volúmenes que necesitan: services: web: image: nginx:latest ports: - "8080:80" volumes: - ./web:/usr/share/nginx/html depends_on: - db db: image: postgres:16 environment: POSTGRES_USER: curso POSTGRES_PASSWORD: secreto POSTGRES_DB: aplicacion volumes: - datos-db:/var/lib/postgresql/data volumes: datos-db: Qué hace Compo...
Leer más