Come installare Emby Media Server su Ubuntu 22.04

Emby Media Server su Ubuntu 22.04: installazione pulita e prima verifica

Emby è un media server che serve per organizzare e distribuire film, serie, musica e foto in rete locale o da remoto. Su Ubuntu 22.04 l’installazione è lineare, ma conviene farla con un minimo di disciplina operativa: repository corretto, servizio systemd verificato, porta aperta solo dove serve, e primo accesso web controllato prima di toccare librerie e transcodifica.

Qui sotto trovi una procedura pensata per un server Ubuntu 22.04 LTS aggiornato, con accesso amministrativo via SSH e con l’obiettivo di arrivare a un’installazione funzionante e verificabile, non solo “pacchetto installato”.

Prerequisiti e contesto operativo

Prima di iniziare, verifica di avere:

• Ubuntu 22.04 aggiornato
• Accesso sudo
• Connessione Internet per scaricare il pacchetto Emby
• Una porta libera per l’interfaccia web di Emby, di default 8096

Se il server è in produzione o esposto su Internet, considera subito il perimetro: Emby ascolta su porte note e va protetto con firewall, reverse proxy e TLS se l’accesso non resta confinato alla LAN.

Controllo base del sistema:

lsb_release -a
uname -r
ip a

Atteso: Ubuntu 22.04 e rete funzionante. Se la macchina non ha connettività, il problema non è Emby ma la base di sistema.

Aggiornare il sistema prima dell’installazione

Parti da un sistema allineato. È il modo più semplice per evitare dipendenze vecchie o pacchetti parzialmente configurati.

sudo apt update
sudo apt upgrade -y

Se vuoi ridurre rumore e capire se ci sono problemi lato package manager:

apt list --upgradable

Atteso: nessun errore su repository o lock di dpkg. Se trovi lock attivi, verifica che non ci sia un altro processo di aggiornamento in corso.

Aggiungere il repository Emby

Emby distribuisce pacchetti dedicati per Linux. Su Ubuntu conviene usare il repository ufficiale, così ricevi aggiornamenti coerenti con il progetto.

Importa la chiave del repository e registra la sorgente pacchetti:

sudo apt install -y curl gnupg
curl -fsSL https://repo.emby.media/keys/EmbyRepo.key | gpg --dearmor | sudo tee /usr/share/keyrings/emby.gpg > /dev/null
echo "deb [signed-by=/usr/share/keyrings/emby.gpg] https://repo.emby.media/ubuntu jammy main" | sudo tee /etc/apt/sources.list.d/emby.list

Nota pratica: jammy è la codename di Ubuntu 22.04. Se il sistema è su un’altra release, questa riga va adattata. Non dare per scontato che il repository sia identico tra versioni diverse.

Ricarica gli indici:

sudo apt update

Atteso: il repository Emby compare nell’output senza errori di firma o TLS. Se compare un errore sulla chiave o sulla sorgente, fermati qui e verifica il file in /etc/apt/sources.list.d/emby.list e la presenza di /usr/share/keyrings/emby.gpg.

Installare Emby Server

Con il repository configurato, installa il pacchetto:

sudo apt install -y emby-server

Durante l’installazione, il pacchetto crea il servizio systemd e prepara la directory dati dell’applicazione. Se la macchina è poco dotata di RAM, la prima indicizzazione potrebbe essere lenta, ma questo non impedisce l’avvio del servizio.

Verifica che il pacchetto sia presente:

dpkg -l | grep emby-server

Atteso: una riga con stato ii. Se non c’è, l’installazione non è andata a buon fine e conviene leggere l’ultimo output di apt prima di riprovare.

Verificare e avviare il servizio systemd

Dopo l’installazione, controlla lo stato del servizio:

systemctl status emby-server --no-pager

Atteso: servizio active (running). Se risulta failed, la cosa più utile è leggere il journal:

journalctl -u emby-server -b --no-pager

Se vuoi forzare l’avvio e abilitare l’esecuzione automatica al boot:

sudo systemctl enable --now emby-server

Controllo rapido della porta di ascolto:

sudo ss -ltnp | grep 8096

Atteso: un processo Emby in ascolto su 0.0.0.0:8096 o sull’interfaccia prevista. Se ascolta solo su localhost, il problema può essere la configurazione del bind o una restrizione di rete.

Aprire il firewall in modo controllato

Se usi UFW, consenti la porta web solo da dove serve davvero. Per un test locale o in LAN:

sudo ufw allow 8096/tcp

Se vuoi esporre anche l’accesso sicuro tramite HTTPS dietro reverse proxy, la porta pubblica dovrebbe essere quella del proxy, non quella nativa di Emby. In quel caso, 8096 resta interna.

Verifica lo stato del firewall:

sudo ufw status verbose

Atteso: regola presente per 8096/tcp oppure policy coerente con il tuo schema di accesso. Se UFW non è attivo, non aprire porte a caso: definisci prima il perimetro.

Primo accesso alla console web

Da browser, apri:

http://IP_DEL_SERVER:8096

Se sei sulla macchina locale, puoi usare anche:

http://127.0.0.1:8096

Il wizard iniziale ti chiederà lingua, utente amministratore, librerie multimediali e preferenze di accesso remoto. In questa fase non correre: l’obiettivo è verificare che il servizio risponda, non importare subito mezza libreria.

Se la pagina non si apre, la sequenza di controllo minima è questa:

1. systemctl status emby-server
2. ss -ltnp | grep 8096
3. ufw status verbose
4. curl -I http://127.0.0.1:8096

Atteso: risposta HTTP, anche solo 200, 302 o un header coerente con l’applicazione. Se il curl locale fallisce, il problema è sul servizio, non sul firewall esterno.

Configurare le librerie multimediali

Emby lavora bene quando le directory sono ordinate. Prima di aggiungere contenuti, conviene avere una struttura chiara. Esempio:

/srv/media/movies
/srv/media/tv
/srv/media/music
/srv/media/photos

Verifica i permessi del path che userà Emby. Il servizio gira con un utente dedicato e deve poter leggere i file. Un controllo utile è:

ps -eo user,group,comm | grep emby
ls -ld /srv/media /srv/media/movies

Se i file non sono leggibili, la libreria apparirà vuota o parziale. In quel caso correggi i permessi sul contenuto, non sul servizio in modo indiscriminato.

Approccio prudente: concedi lettura al gruppo appropriato oppure organizza una directory dedicata con ownership coerente. Evita chmod -R 777: risolve solo il sintomo e apre un buco inutile.

Verificare transcodifica e supporto hardware

Se prevedi streaming fuori casa o dispositivi eterogenei, la transcodifica diventa importante. Su Ubuntu 22.04 Emby può usare CPU e, se presente, accelerazione hardware tramite VAAPI o NVENC, a seconda della GPU e dei driver.

Controlli rapidi lato host:

lspci | egrep -i 'vga|3d|display'
ls -l /dev/dri

Atteso: presenza del dispositivo grafico e, se usi VAAPI, dei nodi in /dev/dri. Se la transcodifica è lenta, la prima diagnosi non è Emby ma disponibilità CPU, driver e codec.

Nel pannello Emby, la sezione relativa a riproduzione e transcodifica va calibrata sui limiti reali della macchina. Un server piccolo può gestire bene il direct play ma non molte transcodifiche simultanee.

Mettere Emby dietro HTTPS con reverse proxy

Su Internet, non esporre l’interfaccia in chiaro se puoi evitarlo. La pratica migliore è mettere Emby dietro Nginx o Apache con TLS. In questo modo la porta 8096 resta interna e il proxy gestisce certificato, HSTS e regole di accesso.

Schema tipico:

• Utente → HTTPS su 443
• Reverse proxy → Emby su 8096 in LAN o localhost
• Firewall → consente 443 pubblica e blocca 8096 dall’esterno

Se usi Nginx, il proxy deve inoltrare anche gli header necessari per WebSocket e streaming. Se usi Apache, serve una configurazione equivalente con proxy e proxy_wstunnel quando richiesto.

Controllo minimo del proxy:

curl -I https://media.tuodominio.tld

Atteso: certificato valido e risposta del front-end. Se il proxy mostra 502 o 504, il problema è il collegamento verso Emby o il servizio backend non è pronto.

Backup, aggiornamenti e manutenzione

Una volta funzionante, conviene trattare Emby come servizio da mantenere. Le aree da preservare sono configurazione, database interno e librerie. Prima di aggiornare il sistema o Emby, fai un backup delle directory dati rilevanti.

I path possono variare in base alla versione e al packaging, quindi non andare a memoria: verifica la directory effettiva del servizio e fai una copia coerente. Se non sai dove si trovano i dati, ispeziona il servizio e i file di configurazione prima di procedere.

Controlli utili:

systemctl cat emby-server
sudo find /var/lib -maxdepth 2 -iname '*emby*' -o -iname '*Emby*'

Se devi aggiornare il pacchetto:

sudo apt update
sudo apt install --only-upgrade emby-server

Rollback pratico: ripristino del pacchetto precedente solo se hai il repository o il file .deb disponibile, più restore dei dati da backup se qualcosa si corrompe. Senza backup, non c’è rollback serio.

Problemi comuni e diagnosi rapida

Se Emby non parte, le cause più frequenti sono poche e ripetitive:

1. Porta già occupata da un altro servizio
2. Permessi errati sulle directory dati o media
3. Dipendenze mancanti o installazione incompleta
4. Spazio disco insufficiente
5. Problemi di rete o firewall che impediscono l’accesso al pannello

Comandi utili per una prima diagnosi:

df -h
free -h
sudo ss -ltnp | grep -E '8096|8920'
journalctl -u emby-server -b --no-pager | tail -n 100

Atteso: disco con spazio libero, RAM coerente, porta in ascolto e log senza errori ripetuti. Se trovi errori di database o file system, fermati e fai copia dei dati prima di tentare fix aggressivi.

Conclusione operativa

A questo punto Emby è installato, il servizio è attivo, la porta è verificata e l’interfaccia web risponde. Il passo successivo non è “caricare tutto”, ma rifinire l’architettura: permessi delle librerie, accesso remoto, HTTPS e backup.

Se vuoi una installazione robusta, la regola pratica è semplice: Emby deve essere raggiungibile in modo controllato, aggiornabile senza sorprese e con dati recuperabili. Il resto viene dopo.

Assunzioni: Ubuntu 22.04 LTS, repository ufficiale Emby disponibile, accesso amministrativo via sudo, porta 8096 usata per il primo avvio e nessun reverse proxy preesistente che alteri il flusso di accesso.