Installare Jellyfin su Debian o Ubuntu
Installa Jellyfin dal suo repository ufficiale, pubblicalo in HTTPS con Caddy, gestisci gli account e comprendi i limiti della transcodifica senza GPU, con aggiornamenti e backup.
In questa pagina
I tuoi valori
Inseriscili una volta: i comandi della guida si aggiornano.
Questa guida spiega come installare Jellyfin, un media server libero, dal suo repository ufficiale. La procedura guidata di configurazione si completa tramite un tunnel SSH, poi Caddy pubblica il servizio in HTTPS.
Al termine della guida, Jellyfin risponde su https://jellyfin.tuo-dominio.com, la sua porta resta chiusa da Internet, ogni persona ha il proprio account e sai che cosa il tuo server può davvero trasmettere senza scheda grafica.
Ordina un Server
Questa guida si applica ai server che amministri tu stesso:
Prerequisiti
- Un server amd64 o arm64 con Debian 12 o 13, oppure Ubuntu 22.04 o 24.04
- Un accesso SSH con un utente che dispone di
sudo - UFW attivo, configurato con la guida Configurare il firewall UFW senza perdere l'accesso SSH
- Caddy, installato con la guida Caddy come reverse proxy con HTTPS automatico
- Un record DNS A per
jellyfin.tuo-dominio.comversoIP_DEL_TUO_SERVER, ad esempio con la guida Creare un record A - Spazio su disco sufficiente per i tuoi media, i metadati e la cache di transcodifica
La documentazione di Jellyfin consiglia 8 GB di memoria e un SSD da 100 GB per il sistema, i file di Jellyfin e la cache di transcodifica, media esclusi. Per l'accesso da remoto, suggerisce almeno 20 Mbit/s in upload.
Porte utilizzate
| Porta | Direzione | Ruolo | Da aprire |
|---|---|---|---|
| 80/tcp | In entrata | Validazione del certificato e reindirizzamento a HTTPS | Sì |
| 443/tcp | In entrata | Accesso HTTPS a Jellyfin | Sì |
| 443/udp | In entrata | HTTP/3 | Consigliato |
| 8096/tcp | Locale | Interfaccia HTTP di Jellyfin | No |
| 8920/tcp | Locale | HTTPS integrato, non usato qui | No |
| 7359/udp | Locale | Rilevamento sulla rete locale, inutile su un server remoto | No |
Passo 1: verificare il firewall
sudo ufw status verbose
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 443/udpIl primo comando deve indicare Status: active e una policy in entrata deny. In caso contrario, fermati e attiva UFW. Non aggiungere alcuna regola per 8096.
Passo 2: aggiungere il repository ufficiale
Installa gli strumenti necessari e la chiave di firma del repository:
sudo apt update
sudo apt install -y curl gnupg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor --yes -o /etc/apt/keyrings/jellyfin.gpgSolo su Ubuntu, attiva il componente Universe, che fornisce alcune dipendenze di FFmpeg:
sudo apt install -y software-properties-common
sudo add-apt-repository -y universeDichiara poi il repository:
export VERSION_OS="$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release)"
export VERSION_CODENAME="$(awk -F'=' '/^VERSION_CODENAME=/{ print $NF }' /etc/os-release)"
export DPKG_ARCHITECTURE="$(dpkg --print-architecture)"
cat <<EOF | sudo tee /etc/apt/sources.list.d/jellyfin.sources
Types: deb
URIs: https://repo.jellyfin.org/${VERSION_OS}
Suites: ${VERSION_CODENAME}
Components: main
Architectures: ${DPKG_ARCHITECTURE}
Signed-By: /etc/apt/keyrings/jellyfin.gpg
EOF
sudo apt updatePasso 3: installare una versione precisa
Jellyfin chiede di non saltare nessuna versione maggiore durante gli aggiornamenti. Questa guida installa quindi una versione scelta, poi la blocca perché un apt upgrade non la cambi senza che tu lo voglia.
I pacchetti hanno un suffisso specifico del tuo sistema, ad esempio deb13 o ubu2404:
. /etc/os-release
case "$ID" in
debian) SUFFIX="deb${VERSION_ID}" ;;
ubuntu) SUFFIX="ubu$(echo "$VERSION_ID" | tr -d .)" ;;
esac
echo "$SUFFIX"
apt-cache madison jellyfin-server | head -n 5Installa la versione, poi bloccala:
sudo apt install -y "jellyfin=12.4+${SUFFIX}" "jellyfin-server=12.4+${SUFFIX}" "jellyfin-web=12.4+${SUFFIX}"
sudo apt-mark hold jellyfin jellyfin-server jellyfin-webIl pacchetto installa anche jellyfin-ffmpeg, la versione di FFmpeg adatta a Jellyfin. Controlla il servizio:
systemctl status jellyfin --no-pager
curl -fsS http://127.0.0.1:8096/healthL'ultimo comando deve restituire Healthy. Dal tuo computer, la porta deve restare chiusa:
nc -vz -w 5 IP_DEL_TUO_SERVER 8096Questo comando deve fallire. Se nc non è disponibile, apri http://IP_DEL_TUO_SERVER:8096 in un browser: la pagina non deve caricarsi. Se la connessione riesce, arresta Jellyfin con sudo systemctl stop jellyfin e correggi il firewall prima di continuare.
Passo 4: preparare i media
Crea una cartella leggibile dal servizio Jellyfin, in cui il tuo utente possa scrivere:
sudo mkdir -p /srv/media/movies /srv/media/shows /srv/media/music
sudo chown -R TUO_USER:jellyfin /srv/media
sudo chmod -R u=rwX,g=rX,o= /srv/media
sudo find /srv/media -type d -exec chmod g+s {} +Dal tuo computer, invia i file con rsync:
rsync -avh --progress ./my-videos/ TUO_USER@IP_DEL_TUO_SERVER:/srv/media/movies/Passo 5: completare la procedura guidata tramite un tunnel SSH
Dal tuo computer, apri un tunnel e lascia aperta questa sessione:
ssh -L 8096:127.0.0.1:8096 TUO_USER@IP_DEL_TUO_SERVERApri http://localhost:8096, poi segui la procedura guidata:
- Scegli la lingua.
- Crea l'account amministratore con una password lunga e unica.
- Aggiungi le tue librerie selezionando le cartelle di
/srv/media, oppure salta questo passaggio. - Scegli la lingua dei metadati.
- Lascia selezionata l'opzione Abilita connessioni remote a questo server: dietro il proxy, i tuoi visitatori verranno visti come remoti.
Passo 6: limitare Jellyfin al loopback
Accedi, poi apri Pannello di controllo > Rete e compila:
| Campo | Valore | Ruolo |
|---|---|---|
| In ascolto solo su indirizzo locale | 127.0.0.1 |
Jellyfin è in ascolto solo sul server |
| Proxy conosciuti | 127.0.0.1 |
Jellyfin accetta gli header X-Forwarded-* di Caddy |
Salva, poi riavvia il servizio e controlla l'ascolto:
sudo systemctl restart jellyfin
sudo ss -ltnp | grep 8096
sudo grep -A1 -E '<(KnownProxies|LocalNetworkAddresses)>' /etc/jellyfin/network.xmlLa porta deve comparire solo su 127.0.0.1:8096. Il tunnel SSH continua a funzionare.
Senza un proxy conosciuto, Jellyfin ignora l'indirizzo trasmesso da Caddy e considera tutti i visitatori come locali: le restrizioni di accesso remoto non si applicano più.
Passo 7: pubblicare Jellyfin in HTTPS
Aggiungi questo sito in /etc/caddy/Caddyfile, oppure in un file di /etc/caddy/sites/:
jellyfin.tuo-dominio.com {
reverse_proxy 127.0.0.1:8096
}Caddy inoltra i WebSocket usati da Jellyfin senza bisogno di impostazioni particolari. Non attivare un log di accesso completo su questo sito: alcuni URL di Jellyfin possono contenere un parametro api_key.
sudo caddy fmt --overwrite /etc/caddy/Caddyfile
sudo -u caddy caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile
sudo systemctl reload caddyVerificare il risultato
curl -I http://jellyfin.tuo-dominio.com
curl -fsS https://jellyfin.tuo-dominio.com/healthIl primo comando deve restituire un reindirizzamento 308 verso HTTPS, il secondo Healthy. Accedi poi su https://jellyfin.tuo-dominio.com, avvia un video e verifica che parta. Nelle app Jellyfin, indica questo stesso indirizzo come server.
Gestire gli account
In Pannello di controllo > Utenti, crea un account per ogni persona con Aggiungi Utente. Per guardare i tuoi contenuti, usa tu stesso un account senza diritti di amministrazione.
Per ogni account, controlla queste impostazioni:
- limita l'accesso alle sole librerie utili;
- attiva Nascondi questo utente dalla schermata di accesso per non esporre l'elenco degli account;
- compila Tentativi di login falliti prima che l'utente sia bloccato, ad esempio con
5. Questo blocco non è attivo per impostazione predefinita, e l'account viene disattivato una volta raggiunta la soglia; - deseleziona Abilita la riproduzione di video che necessita di transcodifica se il server non regge il carico.
Jellyfin non offre un'autenticazione a due fattori nativa: imponi password lunghe e uniche. Per riattivare un account bloccato, un amministratore deseleziona Disabilita questo utente nel suo profilo. Tieni quindi un secondo account amministratore di riserva.
Capire i limiti senza GPU
Jellyfin può riprodurre un file in quattro modi, dal più leggero al più costoso:
| Modalità | Elaborazione | Carico del server |
|---|---|---|
| Direct Play | File inviato così com'è | Quasi nullo |
| Remux | Contenitore cambiato, flussi conservati | Basso |
| Direct Stream | Audio convertito, video conservato | Da basso a moderato |
| Transcode | Video ricodificato al volo | Molto alto |
Per restare in buone condizioni:
- Privilegia formati letti nativamente dai tuoi dispositivi, consultando la tabella di compatibilità dei codec.
- Controlla la modalità di riproduzione nel pannello di controllo durante una trasmissione: indica se un video viene transcodificato e perché.
- Blocca la transcodifica video per gli account interessati. Un file incompatibile potrebbe allora rifiutarsi di partire, ma non saturerà più il server.
- Limita i thread in Pannello di controllo > Riproduzione > Transcodifica, con Transcodifica numero di thread. Il server resta reattivo, ma la riproduzione può risultare a scatti.
- Evita un limite di bitrate troppo basso in Riproduzione > Streaming. Un video il cui bitrate supera Bitrate limite per lo streaming via internet viene transcodificato per adattarsi.
- Tieni d'occhio il disco: i file temporanei vanno in
/var/cache/jellyfin/transcodes. Prevedi circa la dimensione del tuo file più grande, moltiplicata per il numero di flussi simultanei.
Se il tuo server dispone di una GPU compatibile, segui la documentazione Accelerazione hardware. Tieni conto anche della banda e del volume di traffico della tua offerta: ogni flusso consuma un bitrate vicino a quello del file.
Aggiornare Jellyfin
Jellyfin non sa tornare indietro: al primo avvio, le migrazioni modificano i dati. Leggi le note di rilascio e fai un backup prima di ogni aggiornamento.
Consulta la versione installata e quelle disponibili:
jellyfin --version
sudo apt update
apt-cache madison jellyfin-serverDopo il backup, sostituisci 12.4 con la versione di destinazione:
. /etc/os-release
case "$ID" in
debian) SUFFIX="deb${VERSION_ID}" ;;
ubuntu) SUFFIX="ubu$(echo "$VERSION_ID" | tr -d .)" ;;
esac
TARGET=12.4
sudo apt-mark unhold jellyfin jellyfin-server jellyfin-web
sudo apt install -y "jellyfin=${TARGET}+${SUFFIX}" "jellyfin-server=${TARGET}+${SUFFIX}" "jellyfin-web=${TARGET}+${SUFFIX}"
sudo apt-mark hold jellyfin jellyfin-server jellyfin-web
sudo journalctl -u jellyfin --no-pager -n 50Backup e ripristino
Da Jellyfin 10.11, Pannello di controllo > Backup > Crea Backup produce un archivio mentre il server è in funzione. Viene salvato in /var/lib/jellyfin/data/backups, con almeno 5 GB liberi richiesti, e si ripristina dalla stessa pagina. Copia questi archivi fuori dal server.
Il metodo manuale è adatto prima di un aggiornamento, perché conserva tutta la configurazione e si esegue a servizio fermo:
sudo systemctl stop jellyfin
sudo mkdir -p /var/backups/jellyfin
sudo tar -czpf "/var/backups/jellyfin/jellyfin-$(date +%F)-$(dpkg-query -W -f='${Version}' jellyfin-server).tar.gz" /etc/jellyfin /var/lib/jellyfin
sudo systemctl start jellyfin
sudo chmod -R go-rwx /var/backups/jellyfinIl nome del file contiene la versione: ripristinalo con questa stessa versione. Verifica che l'archivio contenga il database:
sudo sh -c 'tar -tzf "$(ls -1t /var/backups/jellyfin/*.tar.gz | head -n 1)" | grep "jellyfin.db$"'Per ripristinare, sostituisci il nome dell'archivio:
ARCHIVE=/var/backups/jellyfin/jellyfin-2026-11-18-12.4+deb13.tar.gz
sudo systemctl stop jellyfin
sudo mv /var/lib/jellyfin /var/lib/jellyfin.bak
sudo mv /etc/jellyfin /etc/jellyfin.bak
sudo tar -xzpf "$ARCHIVE" -C /
sudo systemctl start jellyfinQuesti backup non contengono i tuoi media. Conserva /srv/media separatamente, ad esempio con rsync verso un'altra posizione.
In caso di problemi
Unable to locate package jellyfin o errore del repository
Controlla il file del repository e il nome della tua versione:
cat /etc/apt/sources.list.d/jellyfin.sources
sudo apt updateSuites deve valere bookworm, trixie, jammy o noble. URIs deve terminare con debian o ubuntu.
Version '12.4+...' for 'jellyfin' was not found
La variabile SUFFIX è vuota oppure la versione non esiste per il tuo sistema. Esegui echo "$SUFFIX", poi confronta con apt-cache madison jellyfin-server.
Dipendenze di jellyfin-ffmpeg non soddisfatte su Ubuntu
Il componente Universe non è attivo. Riesegui il comando add-apt-repository del passo 2, poi sudo apt update.
address already in use
Un altro programma usa la porta 8096:
sudo ss -ltnp | grep 8096
sudo journalctl -u jellyfin --no-pager -n 50Errore 502 nel browser
Jellyfin è fermo o non è in ascolto su 127.0.0.1:8096. Verifica con systemctl status jellyfin --no-pager e curl -fsS http://127.0.0.1:8096/health. Al primo avvio dopo un aggiornamento, le migrazioni possono richiedere tempo.
Interfaccia inaccessibile dopo una modifica della rete
Correggi direttamente la configurazione, a servizio fermo:
sudo systemctl stop jellyfin
sudo nano /etc/jellyfin/network.xml
sudo systemctl start jellyfinLocalNetworkAddresses e KnownProxies devono contenere ciascuno <string>127.0.0.1</string>.
Le connessioni remote vengono rifiutate
Verifica che Abilita connessioni remote a questo server sia selezionato in Pannello di controllo > Rete, e che anche il profilo dell'utente lo consenta.
Una libreria resta vuota
Il servizio probabilmente non ha accesso ai file:
sudo -u jellyfin ls -la /srv/media/moviesIn caso di Permission denied, riesegui i comandi del passo 4, poi rilancia la scansione della libreria.
La riproduzione va a scatti o il processore resta al 100 %
Il video probabilmente viene transcodificato. Controlla la modalità di riproduzione nel pannello di controllo, poi applica i consigli della sezione sui limiti senza GPU. Gli errori di conversione si trovano nei file di /var/log/jellyfin:
sudo ls -lt /var/log/jellyfin | headNo space left on device durante una riproduzione
La cache di transcodifica ha riempito il disco:
df -h /var/cache/jellyfin
sudo du -sh /var/cache/jellyfin/transcodes