Jellyfin è un media server libero e gratuito: raccoglie film, serie e musica che avete già su disco e li porta su TV, telefono e browser, senza abbonamenti né account esterni. La versione stabile è la 12.4 del 26 ottobre 2026, una versione di manutenzione che aggiorna .NET alla 10.0.14. Questa guida la installa con Docker Compose su un server Linux e affida la transcodifica alla grafica integrata Intel, con Quick Sync (QSV).
In breve
- Tempo: 45–60 minuti, più la prima scansione.
- Difficoltà: media.
- Cosa serve: un PC con Linux, Docker e il plugin Compose, un processore Intel con grafica integrata, i vostri file video.
- Risultato: Jellyfin raggiungibile in casa sulla porta 8096, con transcodifica hardware, backup e una strada prudente per l’accesso da fuori.
Versioni: Jellyfin 12.4 (server e web, 26 ottobre 2026), Docker Engine 29.9.3, Docker Compose v5.7.1, Caddy v2.11.9. La procedura segue la documentazione ufficiale di Jellyfin e il riferimento dei comandi di Docker, verificati il 15 novembre 2026.
A chi serve, e che cosa cambia con la serie 12
Serve a chi ha una macchina sempre accesa e vuole una videoteca personale, con locandine e trame, su ogni schermo di casa. Chi conosce Jellyfin ricorda numeri come 10.10 o 10.11: dalla prima candidata della 12.0 il progetto ha tolto il «10.» iniziale dalla numerazione, così la serie successiva alla 10.11 si chiama 12.
Cosa serve prima di iniziare
Linux. Su Windows e macOS il container non è supportato e la transcodifica hardware non funziona: lì Jellyfin si installa in modo nativo.
Docker con il plugin Compose. Se manca, seguite Docker e Docker Compose su Ubuntu e Debian.
L’hardware giusto. Per un server con grafica integrata la documentazione raccomanda un Intel Core i5-11400, un Pentium Gold G7400, un Intel N100 o modelli più recenti, 8 GB di RAM, 100 GB di SSD e rete cablata Gigabit: raccomandazioni, non requisiti minimi. Da evitare gli Intel delle serie J, M, N e Y fino all’undicesima generazione, quasi tutti i computer a scheda singola, i NAS preassemblati con processori lenti e la grafica AMD. Senza GPU la transcodifica pesa tutta sul processore. Gli Intel con la sigla che finisce in «F» non hanno grafica integrata.
L’immagine ufficiale, jellyfin/jellyfin. Esistono immagini non ufficiali, come quelle di LinuxServer.io e hotio, basate su Ubuntu; LinuxServer.io, per esempio, colloca i dati in percorsi diversi. Comandi e percorsi di questa guida valgono solo per l’immagine ufficiale.
Passo 1: cartelle e nomi dei file
Il riconoscimento dipende dai nomi. Ogni film va in una cartella con lo stesso nome del file; anno e identificativo del database sono facoltativi ma aiutano. Le serie vanno in cartelle per stagione chiamate Season 01, mai S01, con lo zero davanti. Con i nomi d’esempio della documentazione:
/path/to/media
├── Movies
│ └── Jellyfin Documentary (2030) [imdbid-tt00000000]
│ └── Jellyfin Documentary (2030) [imdbid-tt00000000].mkv
└── Shows
└── Series Name A (2010)
└── Season 01
└── Series Name A S01E01.mkvEvitate nei nomi < > : " / | ? *. Poi create le cartelle per configurazione e cache:
mkdir /path/to/config
mkdir /path/to/cacheQui e nel resto della guida sostituite /path/to/… con percorsi reali del vostro server.
Passo 2: il file Compose
In una cartella dedicata create docker-compose.yml. È il modello della pagina «Container», ridotto a una sola cartella di media montata in sola lettura:
services:
jellyfin:
image: jellyfin/jellyfin
container_name: jellyfin
user: uid:gid
ports:
- 8096:8096/tcp
- 7359:7359/udp
volumes:
- /path/to/config:/config
- /path/to/cache:/cache
- type: bind
source: /path/to/media
target: /media
read_only: true
restart: 'unless-stopped'Al posto di uid:gid scrivete i numeri del vostro utente, che danno id -u e id -g: spesso 1000:1000. Così Jellyfin non gira come root; quell’utente deve poter scrivere in config e cache e leggere i media. La porta 8096 è l’interfaccia web, la 7359/UDP serve ai client per trovare il server in rete locale.
Passo 3: avvio e procedura guidata
docker compose up -dAprite nel browser http://IP-DEL-SERVER:8096, per esempio http://10.0.0.2:8096. La procedura guidata chiede lingua, account amministratore con una password robusta e librerie: con il pulsante + scegliete il tipo in «Content Type», un nome in «Display Name» e la cartella, cioè /media/Movies o /media/Shows. Il tipo «mixed» è sconsigliato. Seguono lingua e regione dei metadati, poi la rete: la documentazione consiglia di attivare «Allow remote access to this server» e di lasciare spenta la mappatura automatica delle porte, che usa UPnP. La prima opzione non apre nulla verso Internet: dice solo a Jellyfin di accettare collegamenti da indirizzi che non considera locali, come quelli di Tailscale o dei visitatori che passano dal proxy, mentre la raggiungibilità da fuori dipende soltanto da come configurate router, VPN o proxy.
Verifica: dopo l’accesso i titoli compaiono con locandine e trame. Cartelle dei media invisibili nella procedura guidata possono indicare un problema di permessi: ricontrollate user: e i diritti sulle cartelle.
Passo 4: la transcodifica hardware con Intel
Su Linux QSV è il metodo preferito per le GPU Intel più diffuse e funziona da Broadwell, la quinta generazione Core, in poi; Ice Lake, Jasper Lake, Elkhart Lake e precedenti stanno perdendo il supporto a QSV. La grafica di dodicesima e tredicesima generazione richiede il kernel 6.2 o successivo. L’immagine ufficiale contiene già driver e runtime OpenCL: va solo aperto l’accesso alla GPU. Sull’host controllate il dispositivo e il numero del gruppo render:
ls -l /dev/dri
getent group render | cut -d: -f3Su alcune distribuzioni il gruppo si chiama video o input. Nel file Compose, sotto restart, aggiungete queste righe, con il numero trovato al posto di 122:
group_add:
- '122'
devices:
- /dev/dri/renderD128:/dev/dri/renderD128Con una seconda GPU il dispositivo diventa renderD129. La pagina Intel indica come necessari solo il gruppo e il dispositivo. Il suo esempio usa anche la rete host (network_mode: 'host'), che la pagina «Container» definisce facoltativa e indispensabile solo per il DLNA: qui resta la rete bridge predefinita, con le porte del passo 2. Ricreate il container e interrogate i codec:
docker compose up -d
docker exec -it jellyfin /usr/lib/jellyfin-ffmpeg/vainfoLa riga del driver iHD indica il supporto a QSV e VA-API. Per il tone mapping da HDR a SDR controllate anche OpenCL:
docker exec -it jellyfin /usr/lib/jellyfin-ffmpeg/ffmpeg -v verbose -init_hw_device vaapi=va -init_hw_device opencl@vaInfine attivate QSV dalla dashboard e togliete la spunta ai codec che vainfo non elenca. La documentazione non indica il percorso dei menu: dice solo di abilitare QSV o VA-API in Jellyfin.
Verifica: sull’host installate gli strumenti con sudo apt update && sudo apt install -y intel-gpu-tools e lanciate sudo intel_gpu_top. Avviate un video nel browser abbassando risoluzione o bitrate: le righe Video e Render/3D devono salire, e la dashboard deve indicare Transcode come tipo di riproduzione.
Per le schede NVIDIA e AMD la documentazione ha pagine dedicate che questa guida non copre.
Passo 5: i client
La pagina dei client elenca le app ufficiali: Jellyfin Media Player per il desktop, Android, iOS, Android TV e Fire TV, Roku, webOS per i TV LG, Tizen per i Samsung, Xbox e JellyCon per Kodi. Per i televisori controllate lì i collegamenti agli store.
Passo 6: l’accesso da fuori casa
Attenzione: non inoltrate mai la porta 8096 dal router. La documentazione di Jellyfin definisce l’apertura diretta delle porte insicura e non raccomandata, sconsiglia con forza i certificati autofirmati e consiglia di lasciare spenta la mappatura automatica delle porte via UPnP. Le falle Plex2Shell, sfruttate in massa contro i server Plex esposti e non aggiornati, mostrano che cosa rischia un media server raggiungibile da Internet, e Jellyfin non fa eccezione. Da fuori si entra con una VPN o con un reverse proxy in HTTPS, e il server va aggiornato con regolarità.
VPN con Tailscale. Jellyfin la indica quando aprire porte non si può o non si vuole, per esempio dietro CGNAT, che trattiamo in CGNAT e IP pubblico. Serve un account Tailscale. Installate Tailscale sul server e su ogni client e collegatelo alla vostra rete: su Linux con sudo tailscale up, sui telefoni dall’app. Dal client aprite l’indirizzo Tailscale del server, che inizia con 100, seguito da :8096. Con le impostazioni predefinite Jellyfin non considera locali questi indirizzi: per questo «Allow remote access to this server» deve restare attivo.
Reverse proxy con Caddy. È il proxy che Jellyfin consiglia: se i record A o AAAA del vostro dominio puntano all’IP pubblico di casa, ottiene da solo il certificato. Il Caddyfile minimo della documentazione, con Caddy installato sullo stesso server:
example.com
reverse_proxy 127.0.0.1:8096Sul router vanno aperte solo le porte 80 e 443 TCP verso il proxy, più la 443 UDP se volete HTTP/3. Poi, nella dashboard alla voce Networking, inserite in «Known Proxies» l’indirizzo IP da cui Jellyfin vede arrivare le richieste del proxy, più indirizzi separati da virgole, e riavviate Jellyfin. Con Caddy sullo stesso server e Jellyfin in un container, quell’indirizzo può non essere 127.0.0.1 ma quello della rete Docker: controllatelo nei log di Jellyfin prima di scriverlo. Senza questa voce, avverte la documentazione, le limitazioni sull’accesso esterno non funzionano. Proteggete i log del proxy: Jellyfin a volte mette dati di autenticazione nell’URL. Altre configurazioni in reverse proxy con Nginx Proxy Manager e Caddy.
Passo 7: backup e aggiornamenti
Dalla 10.11 c’è un backup integrato: nella dashboard aprite la scheda Backups e premete Create Backup. Il database è sempre incluso, il resto è facoltativo; servono almeno 5 GB liberi. Nell’immagine ufficiale la cartella dei dati di Jellyfin è /config e l’archivio zip finisce nella sua sottocartella data/backups: con il file Compose di questa guida, sul server, /path/to/config/data/backups. Il ripristino si avvia dallo stesso elenco, e il server si riavvia subito.
Il backup manuale va fatto a server fermo, o il database potrebbe non essere recuperabile. La cartella montata su /config contiene dati e configurazione. Dalla cartella del file Compose:
TIMESTAMP=$(date +%Y%m%d%H%M%S)
VERSION=12.4
docker stop jellyfin
sudo mkdir -p /media/backups/jellyfin.${TIMESTAMP}_${VERSION}
sudo cp -a /path/to/config /media/backups/jellyfin.${TIMESTAMP}_${VERSION}/data
docker compose up -dPoi copiatela su un altro disco, per esempio con restic e la regola 3-2-1.
Per aggiornare, prima il backup, poi:
docker compose pull
docker compose up -dJellyfin non ha un meccanismo per tornare indietro: alla prima partenza la nuova versione applica le migrazioni, e la precedente si recupera solo ripristinando un backup. Il tag latest segue l’ultima stabile anche nei salti di serie; per decidere voi quando cambiare, scrivete jellyfin/jellyfin:12 o jellyfin/jellyfin:12.4.
Chi arriva dalla 10.x legga le note della 12.0: aggiornamento diretto da 10.10.7 e 10.11.x, plugin non integrati da rimuovere prima, scansione completa della libreria dopo. Spariscono i prefissi /emby e /mediabrowser.
Verifica: l’archivio zip o la copia datata esistono, e dopo l’aggiornamento la dashboard mostra la nuova versione.
Se qualcosa va storto
error: failed to initialize display da vainfo
La documentazione lo cita nella sezione su Kubernetes, dove la causa sono i gruppi supplementari sbagliati. In Docker quei gruppi si assegnano con group_add: confrontate il numero con quello che dà getent group render | cut -d: -f3, ricreate il container con docker compose up -d e controllate con docker exec jellyfin id che il numero compaia tra i gruppi dell’utente.
In /dev/dri non c’è nessun renderD
Aggiornate il kernel oppure attivate la grafica integrata nel BIOS.
La transcodifica non parte
Guardate prima i log di ffmpeg, come indica la pagina di risoluzione dei problemi.
Film o serie riconosciuti male
Togliete l’elemento dalla cartella, lanciate la scansione da Dashboard > Libraries > Libraries, menu contestuale, Scan library, Refresh; rinominate secondo lo schema del passo 1, rimettetelo e ripetete la scansione.
Errori «Database Locked» nei log
Abbassate nella dashboard il limite delle scansioni parallele.
Funziona in casa ma non da fuori
Controllate router e proxy, e con Caddy la voce «Known Proxies». In Jellyfin l’accesso remoto deve essere attivo sia in Networking sia per l’utente, in Users, Edit User, «Allow remote connections to this server».
Un’app vecchia non si collega più dopo l’aggiornamento
Probabilmente usa i prefissi /emby rimossi nella 12.0: passate a un client ufficiale aggiornato.
Come tornare indietro
Il comando docker compose down ferma e rimuove il container e la rete creata da Compose; configurazione e media restano nelle cartelle. La nostra indicazione: con un Intel recente, Jellyfin in Docker è il modo più pulito di avere una videoteca propria, purché resti dentro casa o raggiungibile solo attraverso una VPN o un proxy in HTTPS, e il backup preceda ogni aggiornamento.
Fonti
- Jellyfin (documentazione, Container)
- Jellyfin (note di rilascio 12.4)
- Jellyfin (note di rilascio 12.0)
- Jellyfin (12.0-rc1, nuova numerazione)
- Jellyfin (documentazione, scelta dell'hardware)
- Jellyfin (documentazione, accelerazione hardware Intel)
- Jellyfin (documentazione, accelerazione hardware)
- Jellyfin (documentazione, transcodifica)
- Jellyfin (documentazione, procedura guidata)
- Jellyfin (documentazione, librerie)
- Jellyfin (documentazione, film)
- Jellyfin (documentazione, serie TV)
- Jellyfin (documentazione, rete)
- Jellyfin (documentazione, reverse proxy)
- Jellyfin (documentazione, Caddy)
- Jellyfin (documentazione, Tailscale)
- Jellyfin (documentazione, backup e ripristino)
- Jellyfin (documentazione, risoluzione dei problemi)
- Jellyfin (client ufficiali)
- Docker Docs (docker compose pull)
- Docker Docs (docker compose up)
- Docker Docs (docker compose down)
- Docker Docs (Compose, servizi: volumes, group_add, devices)
- Jellyfin (Dockerfile dell'immagine ufficiale)
- Jellyfin (sorgente 12.4, cartella dei backup)
- Jellyfin (sorgente 12.4, reti locali predefinite)
Immagine di copertina: Intel NUC 2820FYKH – Front.jpg di Namenloser Hobbyhistoriker, licenza CC BY-SA 4.0, via Wikimedia Commons; elaborazione grafica HardWarfare.
Articolo redatto con il supporto di strumenti di intelligenza artificiale e verificato dalla redazione. Come usiamo l'AI · Come lavoriamo
