Jellyfin Docker Compose: Tu Servidor Multimedia Gratuito 2025

¿Buscas una alternativa gratuita y open source a Plex o Emby? Jellyfin Docker Compose es la solución perfecta para montar tu propio servidor multimedia sin costos ocultos ni suscripciones premium. En esta guía completa, aprenderás a instalar y configurar Jellyfin usando Docker Compose en tu servidor doméstico.

¿Qué es Jellyfin Docker Compose?

Jellyfin es un sistema de medios de código abierto bajo licencia GPL 2.0 que te permite gestionar y transmitir tu biblioteca multimedia desde un servidor dedicado a cualquier dispositivo. A diferencia de alternativas comerciales como Plex o Emby, Jellyfin es completamente gratuito, sin funcionalidades bloqueadas tras muros de pago.

Con más de 46,000 estrellas en GitHub y una comunidad activa de 1,300+ contribuidores, este proyecto se ha consolidado como la opción preferida para usuarios que buscan control total sobre sus medios sin depender de servicios propietarios.

Ventajas de usar Jellyfin Docker Compose

• 100% gratuito y open source: Sin licencias premium ni características restringidas
• Sin telemetría ni rastreo: Tus datos permanecen en tu servidor
• Transcodificación potente: Convierte formatos de vídeo en tiempo real usando jellyfin-ffmpeg
• Multiplataforma: Clientes disponibles para Android, iOS, TV, navegadores y más
• Fácil instalación: Docker Compose simplifica el despliegue y las actualizaciones
• Hardware acceleration: Soporte para GPU Intel QuickSync, NVIDIA NVENC, AMD AMF
• Gestión de usuarios: Perfiles familiares con control parental y restricciones

Requisitos previos

Antes de instalar Jellyfin con Docker Compose, asegúrate de tener:

• Docker y Docker Compose instalados en tu sistema Linux, macOS o Windows
• Mínimo 2GB de RAM (recomendado 4GB+ para transcodificación)
• Espacio en disco suficiente para tu biblioteca multimedia
• Permisos de usuario para ejecutar contenedores Docker

Instalación de Jellyfin Docker Compose paso a paso

Paso 1: Crear estructura de directorios

Primero, crea los directorios necesarios para almacenar la configuración y tus archivos multimedia:

mkdir -p ~/jellyfin/{config,cache,media}
cd ~/jellyfin

Paso 2: Crear archivo docker-compose.yml

Crea tu archivo de configuración para desplegar el servidor multimedia:

services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    container_name: jellyfin
    user: 1000:1000
    network_mode: host
    volumes:
      - ./config:/config
      - ./cache:/cache
      - ./media:/media
    restart: unless-stopped
    environment:
      - JELLYFIN_PublishedServerUrl=http://192.168.1.100:8096
    devices:
      - /dev/dri:/dev/dri  # Para aceleración de hardware Intel

Explicación de la configuración:

• user: 1000:1000 – Ejecuta el contenedor con tu UID/GID (verifica con id -u)
• network_mode: host – Permite descubrimiento automático en red local
• /dev/dri – Habilita aceleración por hardware Intel QuickSync
• JELLYFIN_PublishedServerUrl – Cambia por la IP de tu servidor

Paso 3: Iniciar Jellyfin

Despliega tu servidor multimedia ejecutando:

docker compose up -d

Docker descargará la imagen oficial y arrancará el contenedor en segundo plano.

Paso 4: Configuración inicial

Accede a la interfaz web desde tu navegador:

http://TU-IP-DEL-SERVIDOR:8096

El asistente de configuración te guiará para:

1. Seleccionar idioma preferido
2. Crear tu usuario administrador
3. Añadir bibliotecas multimedia (Películas, Series, Música)
4. Configurar metadatos y scrapers (TheMovieDB, TheTVDB, MusicBrainz)
5. Habilitar acceso remoto si lo necesitas

Configuración avanzada de Jellyfin Docker Compose

Aceleración por hardware NVIDIA

Si tienes una GPU NVIDIA, modifica el archivo Docker Compose para aprovechar NVENC:

services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    container_name: jellyfin
    runtime: nvidia
    environment:
      - NVIDIA_VISIBLE_DEVICES=all
    devices:
      - /dev/nvidia0:/dev/nvidia0
      - /dev/nvidiactl:/dev/nvidiactl

Recuerda instalar NVIDIA Container Toolkit previamente.

Reverse proxy con Traefik

Para acceso externo seguro con HTTPS automático, combina Jellyfin con Traefik:

services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    container_name: jellyfin
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.jellyfin.rule=Host(`jellyfin.tudominio.com`)"
      - "traefik.http.routers.jellyfin.entrypoints=websecure"
      - "traefik.http.services.jellyfin.loadbalancer.server.port=8096"
    networks:
      - proxy

Consulta nuestra categoría de Docker Compose para más configuraciones de reverse proxy.

Organización de tu biblioteca multimedia

Para que la aplicación detecte correctamente tus contenidos, organiza tus archivos así:

media/
├── movies/
│   ├── Avatar (2009)/
│   │   └── Avatar (2009).mkv
│   └── Inception (2010)/
│       └── Inception (2010).mkv
├── tv/
│   └── Breaking Bad/
│       ├── Season 01/
│       │   ├── S01E01.mkv
│       │   └── S01E02.mkv
│       └── Season 02/
└── music/
    └── Artist/
        └── Album/
            └── 01 - Track.flac

Esta estructura permite que los scrapers identifiquen automáticamente películas y series desde bases de datos como TheMovieDB.

Clientes disponibles para Jellyfin

Una de las grandes ventajas del proyecto es su ecosistema multiplataforma:

• Web: Interfaz completa accesible desde cualquier navegador
• Android/Android TV: App nativa disponible en Google Play
• iOS/tvOS: Cliente oficial en App Store
• Roku, Fire TV, Chromecast: Soporte para dispositivos de streaming populares
• Kodi: Plugin JellyCon para integración completa
• Desktop: Aplicaciones para Windows, macOS y Linux

Mantenimiento y actualizaciones

Actualizar tu instalación es sencillo con Docker Compose:

cd ~/jellyfin
docker compose pull
docker compose up -d

Esto descargará la última versión de la imagen y recreará el contenedor sin perder configuración ni datos.

Copias de seguridad

Protege tu configuración haciendo backups periódicos del directorio config:

tar -czf jellyfin-backup-$(date +%Y%m%d).tar.gz ~/jellyfin/config

Solución de problemas comunes

Error de permisos en archivos

Si ves errores de permisos, verifica que el UID/GID del contenedor coincida con el propietario de los archivos:

sudo chown -R 1000:1000 ~/jellyfin/config ~/jellyfin/cache

Transcodificación lenta

Habilita aceleración por hardware en Panel de control → Reproducción → Transcodificación. Selecciona Intel QuickSync, NVIDIA NVENC o AMD AMF según tu hardware.

Puerto 8096 ocupado

Si otro servicio usa el puerto 8096, cámbialo modificando el archivo:

ports:
  - "8097:8096"  # Ahora accede vía puerto 8097

Jellyfin vs Plex vs Emby: Comparativa 2025

Preguntas frecuentes (FAQ)

¿Es Jellyfin realmente gratuito?

Sí, completamente gratuito y de código abierto bajo licencia GPL 2.0. No existen características premium ni muros de pago. Todo el software está disponible sin costo alguno.

¿Puedo usar Jellyfin sin conexión a internet?

Absolutamente. A diferencia de Plex, no requiere autenticación en servidores externos. Funciona perfectamente en redes locales aisladas o sin acceso a internet.

¿Soporta subtítulos automáticos?

Sí, incluye plugins para descargar subtítulos automáticamente desde OpenSubtitles. Soporta formatos SRT, ASS, SSA y VTT con estilos personalizables.

¿Qué formatos de vídeo reproduce?

Reproduce prácticamente cualquier formato gracias a FFmpeg: MKV, MP4, AVI, MOV, WEBM, HEVC/H.265, AV1, VP9, y más. La transcodificación automática convierte formatos no soportados por tu dispositivo.

¿Cómo migro desde Plex a Jellyfin?

No existe migración automática de metadatos de Plex. Deberás reescanear tu biblioteca, aunque la aplicación detectará automáticamente la información desde bases de datos públicas. Mantén la estructura de carpetas organizada para facilitar el proceso.

Conclusión

Jellyfin Docker Compose representa la mejor alternativa gratuita y open source para crear tu servidor multimedia personal. Sin suscripciones, sin telemetría y con control total sobre tus medios, es la elección ideal para usuarios que valoran su privacidad y autonomía.

La combinación de Docker Compose facilita el despliegue, las actualizaciones y el mantenimiento, mientras que la comunidad activa garantiza mejoras continuas y soporte técnico. Si buscas una solución multimedia robusta sin costos recurrentes, esta es tu mejor opción en 2025.

¿Listo para montar tu propio Netflix casero? Descarga el código fuente en GitHub y únete a la revolución del streaming autoalojado.