Instalar e otimizar Jellyfin no Ubuntu: guia passo a passo

Instale Jellyfin pelo método oficial, configure bibliotecas e verifique a aceleração por hardware.

Antes de começar

Use uma versão Ubuntu suportada pelo repositório Jellyfin, acesso sudo e espaço para mídia, metadados e transcodificação temporária. Confira a documentação da versão. Reprodução direta muitas vezes evita transcodificação; desempenho depende de GPU, codecs, clientes e rede.

Instalação oficial

Baixe o script e o checksum oficiais, confirme o resultado OK, examine o script e só então execute com privilégios. Jellyfin também documenta instalação manual do repositório. Verifique o serviço depois.

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

Configuração inicial e acesso

Em uma rede confiável abra http://IP_SERVIDOR:8096, crie administrador com senha forte e configure idioma e bibliotecas. Quando possível, dê ao serviço apenas leitura dos arquivos de mídia. Não exponha a porta 8096 diretamente à internet; use proxy reverso HTTPS ou VPN, autenticação e atualizações regulares.

Aceleração por hardware

Identifique a GPU e os dispositivos de vídeo. Em Dashboard > Playback > Transcoding escolha o método documentado para drivers e hardware: Intel QSV, AMD VA-API ou NVIDIA NVENC. Confira acesso do usuário jellyfin ao dispositivo. Ative apenas codecs e tone mapping suportados. Teste um arquivo que realmente transcodifique e confira logs, CPU/GPU e painel. Não há redução fixa de CPU garantida.

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

Armazenamento temporário

Não mova transcodes automaticamente para /tmp ou RAM: tmpfs pequeno pode esgotar memória e parar a reprodução. Dimensione espaço, memória e sessões simultâneas; altere o caminho apenas com base em medições. Agende miniaturas em horário ocioso e monitore cache e permissões.

Recursos e limites

Jellyfin oferece bibliotecas, contas, clientes e plugins. Codecs, downloads offline, SyncPlay e funções variam por dispositivo e versão. Confira clientes oficiais antes de comprar equipamentos. Avalie e atualize plugins externos separadamente. Faça backup de configuração, metadados e mídia.

Fontes oficiais

Instalação: https://jellyfin.org/docs/general/installation/linux/ ; transcodificação: https://jellyfin.org/docs/general/post-install/transcoding/ ; aceleração: https://jellyfin.org/docs/general/post-install/transcoding/hardware-acceleration/ .