Guía de despliegue

Alojar Jellyfin en un VPS: guía completa 2026

Desplegar en un VPS Cloud →

Tutorial

Alojar Jellyfin en un VPS: guía completa 2026

Autoalojamiento10 min de lectura6 pasos

Jellyfin es el servidor multimedia libre que Plex debería haber sido — sin suscripción, sin servidor de autenticación central, sin recopilación de datos. La tendencia de precios al alza de Plex ha acelerado una migración que muchos retrasaban. Esta guía te lleva desde la instalación Docker hasta la configuración nginx, cubriendo los dos problemas más discutidos en foros: los plugins que desaparecen tras una actualización y la estrategia de almacenamiento cuando tu biblioteca crece.

Contenido· Por qué Jellyfin en 20261/9
  1. 01Por qué Jellyfin en 2026
  2. 02Lo que ofrece Jellyfin
  3. 03Requisitos por caso de uso
  4. 04Instalar Jellyfin en VPS Ubuntu/Debian con Docker Compose
  5. 05Plugins no encontrados — corregir la URL del repositorio
  6. 06Estrategia de almacenamiento para Jellyfin en VPS
  7. 07Transcodificación hardware — VAAPI y NVENC
  8. 08Resolución de problemas — errores frecuentes
  9. 09Desplegar Jellyfin desde el Marketplace de ServOrbit

Por qué Jellyfin en 2026

Les plateformes de streaming centralisées ont relevé leurs tarifs ces dernières années, poussant de nombreux utilisateurs à explorer l'hébergement autonome. Emby, la otra alternativa histórica, también se volcó a un modelo freemium — funciones clave como la transcodificación hardware y los clientes móviles ahora requieren Emby Premiere. Jellyfin nació en 2018 como un fork de Emby con licencia GPLv2 que impide el cierre del código. La versión 10.10 cubre prácticamente todos los casos de uso: streaming adaptativo, transcodificación software y hardware, apps nativas para iOS, Android, Android TV y Roku, SSO OIDC/LDAP y un sistema de plugins extensible.

Lo que ofrece Jellyfin

  • Streaming DLNA y HLS — sirve películas, series y música a todos tus dispositivos, incluyendo TVs sin app nativa.
  • Apps oficiales — iOS, Android, Android TV, Roku, Fire TV, Kodi; interfaz web responsiva para el resto.
  • Transcodificación al vuelo — convierte el formato fuente si el dispositivo destino no lo soporta, por software o GPU.
  • LiveTV y grabación DVR — conecta un sintonizador USB o fuente IPTV para ver y grabar televisión en directo.
  • SSO OIDC y LDAP — integra tu directorio existente o un proveedor de identidad como Authentik o Keycloak.
  • Subtítulos automáticos — plugin OpenSubtitles, extracción de pistas embebidas, renderizado WebVTT.
  • Plugins extendidos — integraciones LastFM, scrobbling, metadatos musicales, tráilers, gestión de colecciones.
  • Sin nube propietaria — ninguna autenticación a través de servidores Plex, ningún dato de reproducción enviado a terceros.

Requisitos por caso de uso

SD y 1080p sin transcodificación (direct play): 2 vCPU y 2 GB RAM bastan para cientos de títulos. 1080p con transcodificación software: 4 vCPU / 4 GB RAM mínimo para dos usuarios simultáneos. 4K HDR con transcodificación software: no recomendado en VPS cloud estándar — prefiere direct play 4K o un servidor dedicado con GPU. Transcodificación hardware GPU (VAAPI/NVENC): requiere acceso al dispositivo /dev/dri o tarjeta NVIDIA — no disponible en la mayoría de VPS cloud.

Instalar Jellyfin en VPS Ubuntu/Debian con Docker Compose

  1. Preparar el VPS e instalar Docker

    apt update && apt upgrade -y
    curl -fsSL https://get.docker.com | sh
    systemctl enable --now docker
  2. Crear la estructura de carpetas

    mkdir -p /opt/jellyfin/{config,cache}
    mkdir -p /mnt/media/{peliculas,series,musica}
    chown -R 1000:1000 /opt/jellyfin /mnt/media
  3. Escribir el archivo docker-compose.yml

    Crea /opt/jellyfin/docker-compose.yml con los bind mounts sobre /config, /cache y /media:ro y la variable JELLYFIN_PublishedServerUrl.

  4. Arrancar el container

    cd /opt/jellyfin
    docker compose up -d
    docker compose logs -f

    Jellyfin escucha en el puerto 8096. Espera la línea Startup complete.

  5. Configurar nginx como reverse proxy con HTTPS

    apt install -y nginx certbot python3-certbot-nginx
    certbot --nginx -d jellyfin.tu-dominio.com
    nginx -t && systemctl reload nginx
  6. Asistente de configuración inicial

    Abre https://jellyfin.tu-dominio.com, crea el administrador, añade tu biblioteca y elige los agentes de metadatos (TheMovieDB para películas, TheTVDB para series).

Plugins no encontrados — corregir la URL del repositorio

Síntoma: Dashboard > Plugins > Catalog = lista vacía.

Causa: La URL del repositorio oficial de plugins cambió entre Jellyfin 10.7 y 10.9 (issue GitHub #16654). La URL antigua releases/plugin/manifest-stable.json ya no responde.

Corrección:
1. Ve a Dashboard > Plugins > Repositories
2. Elimina la entrada con la URL antigua
3. Añade un nuevo repositorio: https://repo.jellyfin.org/files/plugin/manifest.json
4. Guarda y reinicia Jellyfin:

docker compose -f /opt/jellyfin/docker-compose.yml restart

Estrategia de almacenamiento para Jellyfin en VPS

Tamaños estimados: película 1080p = 5 a 15 GB, película 4K HDR = 15 a 60 GB. Ejemplo: 100 películas × 8 GB = 800 GB mínimo.

Opción 1 — Volumen adicional VPS (recomendado para empezar): montado como ext4 en /mnt/media. Ventaja: latencia mínima. Desventaja: coste lineal con el tamaño.

Opción 2 — Hetzner Storage Box (CIFS): hasta 20 TB a bajo coste — €7,64/mes para 2 TB. Latencia aceptable para streaming pre-bufferizado.

Opción 3 — NAS local con túnel Tailscale: ideal para bibliotecas grandes ya constituidas.

Punto de rentabilidad: más allá de 500 GB, el Storage Box casi siempre es más económico.

Transcodificación hardware — VAAPI y NVENC

En un servidor dedicado con procesador Intel Gen 6+ o AMD RDNA, expón el dispositivo en Docker:

devices:
  - /dev/dri/renderD128:/dev/dri/renderD128

Activa en Dashboard > Playback > Hardware Acceleration: selecciona «Intel Quick Sync (VAAPI)». Los VPS cloud estándar no exponen GPU — modo reservado para servidores dedicados.

Limita los flujos simultáneos de transcodificación para evitar la saturación de CPU: Dashboard > Playback > Máximo de flujos de transcodificación simultáneos. Fija 2 o 3 en un VPS de 4 vCPU.

Resolución de problemas — errores frecuentes

Biblioteca vacía tras el escaneo: verifica los permisos — el container corre como UID 1000: chown -R 1000:1000 /mnt/media.

HTTPS roto detrás de nginx: verifica que los headers X-Forwarded-Proto y X-Real-IP se transmiten correctamente.

Transcodificación lenta o error VAAPI: docker exec jellyfin ls /dev/dri para confirmar acceso al dispositivo.

Apps móviles rechazan la conexión: verifica que el certificado TLS es válido y que la renovación automática de Let's Encrypt está activa.

Desplegar Jellyfin desde el Marketplace de ServOrbit

Jellyfin está disponible en el Marketplace de ServOrbit con instalación automatizada completa: container Docker, reverse proxy nginx con HTTPS Let's Encrypt y volumen de almacenamiento dedicado. Obtienes un Jellyfin listo para producción en menos de cinco minutos, conservando acceso SSH completo para modificar la configuración cuando lo necesites.

Tu Jellyfin en producción en 5 minutos

Despliega Jellyfin desde el Marketplace de ServOrbit: instalación automatizada, HTTPS incluido, almacenamiento configurable, VPS bajo tu control total.

¿Necesita ayuda?

Consulte nuestro centro de ayuda y nuestra FAQ, o contacte con nuestro equipo: llamada, WhatsApp o correo electrónico. Soporte en francés, inglés y árabe.

Escribir por WhatsAppse abre en una pestaña nueva