IT

Applicazioni

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.

11 min di lettura, aggiornato il 18 novembre 2026

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

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

Terminale
sudo ufw status verbose
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 443/udp

Il 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:

Terminale
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.gpg

Solo su Ubuntu, attiva il componente Universe, che fornisce alcune dipendenze di FFmpeg:

Terminale
sudo apt install -y software-properties-common
sudo add-apt-repository -y universe

Dichiara poi il repository:

Terminale
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 update

Passo 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:

Terminale
. /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 5

Installa la versione, poi bloccala:

Terminale
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-web

Il pacchetto installa anche jellyfin-ffmpeg, la versione di FFmpeg adatta a Jellyfin. Controlla il servizio:

Terminale
systemctl status jellyfin --no-pager
curl -fsS http://127.0.0.1:8096/health

L'ultimo comando deve restituire Healthy. Dal tuo computer, la porta deve restare chiusa:

Terminale
nc -vz -w 5 IP_DEL_TUO_SERVER 8096

Questo 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:

Terminale
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:

Terminale
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:

Terminale
ssh -L 8096:127.0.0.1:8096 TUO_USER@IP_DEL_TUO_SERVER

Apri http://localhost:8096, poi segui la procedura guidata:

  1. Scegli la lingua.
  2. Crea l'account amministratore con una password lunga e unica.
  3. Aggiungi le tue librerie selezionando le cartelle di /srv/media, oppure salta questo passaggio.
  4. Scegli la lingua dei metadati.
  5. 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:

Terminale
sudo systemctl restart jellyfin
sudo ss -ltnp | grep 8096
sudo grep -A1 -E '<(KnownProxies|LocalNetworkAddresses)>' /etc/jellyfin/network.xml

La 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/:

caddyfile
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.

Terminale
sudo caddy fmt --overwrite /etc/caddy/Caddyfile
sudo -u caddy caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile
sudo systemctl reload caddy

Verificare il risultato

Terminale
curl -I http://jellyfin.tuo-dominio.com
curl -fsS https://jellyfin.tuo-dominio.com/health

Il 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:

Terminale
jellyfin --version
sudo apt update
apt-cache madison jellyfin-server

Dopo il backup, sostituisci 12.4 con la versione di destinazione:

Terminale
. /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 50

Backup 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:

Terminale
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/jellyfin

Il nome del file contiene la versione: ripristinalo con questa stessa versione. Verifica che l'archivio contenga il database:

Terminale
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:

Terminale
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 jellyfin

Questi 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:

Terminale
cat /etc/apt/sources.list.d/jellyfin.sources
sudo apt update

Suites 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:

Terminale
sudo ss -ltnp | grep 8096
sudo journalctl -u jellyfin --no-pager -n 50

Errore 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:

Terminale
sudo systemctl stop jellyfin
sudo nano /etc/jellyfin/network.xml
sudo systemctl start jellyfin

LocalNetworkAddresses 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:

Terminale
sudo -u jellyfin ls -la /srv/media/movies

In 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:

Terminale
sudo ls -lt /var/log/jellyfin | head

No space left on device durante una riproduzione

La cache di transcodifica ha riempito il disco:

Terminale
df -h /var/cache/jellyfin
sudo du -sh /var/cache/jellyfin/transcodes

Riferimenti