Instalar y optimizar Jellyfin en Ubuntu: guía paso a paso

Instala Jellyfin con el método oficial, organiza bibliotecas y comprueba la aceleración por hardware.

Antes de empezar

Usa una versión de Ubuntu compatible con el repositorio Jellyfin, acceso sudo y espacio para medios, metadatos y transcodificación temporal. Consulta la guía de tu versión. La reproducción directa evita a menudo transcodificar; el rendimiento depende de GPU, códecs, clientes y red.

Instalación oficial

Descarga el script y su suma de comprobación, confirma que el resultado sea OK, revisa el script y solo entonces ejecútalo con privilegios. Jellyfin también documenta la configuración manual del repositorio. Comprueba después el servicio.

sudo apt update
sudo apt install curl ca-certificates
curl -fsSLO https://repo.jellyfin.org/install-debuntu.sh
curl -fsSLO https://repo.jellyfin.org/install-debuntu.sh.sha256sum
sha256sum -c install-debuntu.sh.sha256sum
less install-debuntu.sh
sudo bash install-debuntu.sh
sudo systemctl status jellyfin --no-pager

Primera configuración y acceso

Desde una red de confianza abre http://IP_SERVIDOR:8096, crea un administrador con contraseña robusta y configura idioma y bibliotecas. Cuando sea posible, concede al servicio solo lectura sobre los medios. No expongas el puerto 8096 directamente a Internet; usa proxy inverso HTTPS o VPN, autenticación y actualizaciones.

Aceleración de hardware

Identifica GPU y dispositivos de vídeo. En Dashboard > Playback > Transcoding selecciona el método documentado según controladores y hardware: Intel QSV, AMD VA-API o NVIDIA NVENC. Comprueba que jellyfin tenga acceso al dispositivo. Activa solo códecs y tone mapping compatibles. Prueba un archivo que realmente se transcodifique y revisa registros, CPU/GPU y panel. No se garantiza un ahorro fijo de CPU.

lspci -nn | grep -Ei '3d|display|vga'
ls -l /dev/dri/
id jellyfin

Archivos temporales y biblioteca

No muevas automáticamente los transcodes a /tmp o RAM: un tmpfs pequeño puede agotar memoria e interrumpir la reproducción. Calcula espacio, memoria y sesiones simultáneas; cambia la ruta solo si las mediciones lo justifican. Programa las vistas previas fuera de horas punta y vigila caché y permisos.

Funciones y límites

Jellyfin ofrece bibliotecas, usuarios, clientes y complementos. Códecs, descargas sin conexión, SyncPlay y funciones del cliente varían según dispositivo y versión. Revisa los clientes oficiales antes de comprar hardware. Evalúa y actualiza los plugins externos por separado. Haz copias de configuración, metadatos y medios.

Fuentes oficiales

Instalación: https://jellyfin.org/docs/general/installation/linux/ ; transcodificación: https://jellyfin.org/docs/general/post-install/transcoding/ ; aceleración: https://jellyfin.org/docs/general/post-install/transcoding/hardware-acceleration/ .