Come installare qBittorrent su Ubuntu 24.04 e 22.04

qBittorrent su Ubuntu 24.04 e 22.04 si installa senza complicarsi la vita, ma conviene scegliere subito il metodo giusto: pacchetto dei repository Ubuntu, PPA affidabile oppure versione da linea di comando per usi headless. La differenza pratica non è estetica: cambia quanto resti aggiornato, quanto rischi dipendenze vecchie e quanto facilmente puoi gestire l’app da remoto.

Se devi usare qBittorrent su una macchina desktop, il pacchetto dei repository ufficiali può bastare. Se invece vuoi una release più recente, o ti serve il Web UI su un server, il setup va fatto con un minimo di disciplina: installazione, servizio, utente dedicato, porta esposta solo se serve davvero, e verifica finale di stato e log.

Metodo consigliato su Ubuntu 24.04 e 22.04

Per la maggior parte dei casi, la strada più lineare è questa: aggiornare l’indice pacchetti, installare qBittorrent e avviarlo dal menu applicazioni oppure da terminale. Su 22.04 e 24.04 il nome del pacchetto è lo stesso, ma la versione disponibile può cambiare in base al ramo della distribuzione. Prima di fare qualsiasi scelta, controlla cosa offre il repository attivo.

Verifica la versione disponibile così eviti di installare alla cieca:

sudo apt update
apt policy qbittorrent

Nel risultato cerca la riga Candidate: è la versione che installerai con apt install. Se è sufficiente per il tuo caso, puoi procedere senza aggiungere repository esterni.

Installazione da repository Ubuntu

Su una macchina desktop o workstation, l’installazione base è questa:

sudo apt update
sudo apt install qbittorrent

Dopo l’installazione, puoi avviarlo dal launcher grafico oppure da terminale:

qbittorrent

Se l’interfaccia parte ma la finestra non compare, il problema di solito non è il pacchetto: è il profilo utente, l’ambiente grafico o una sessione già attiva in background. In quel caso controlla i processi del tuo utente:

pgrep -a qbittorrent

Se trovi un processo già vivo, chiudilo in modo pulito prima di rilanciare l’applicazione. Evita kill forzati se non hai verificato che l’interfaccia sia realmente bloccata.

Quando conviene un PPA o un pacchetto più recente

Su Ubuntu LTS capita spesso che il repository ufficiale non tenga il passo con le ultime correzioni di qBittorrent. Non è un dramma, ma va deciso consapevolmente: vuoi stabilità del ramo distro o vuoi una release più attuale? Se il motivo è un bug specifico, una regressione o il supporto a una funzione recente, allora un PPA può avere senso. Se invece non hai un’esigenza precisa, resta sui repository Ubuntu.

Prima di aggiungere un PPA, controlla sempre chi lo mantiene e quali pacchetti tocca. La pratica sana è aggiungere il minimo indispensabile e avere chiaro come rimuoverlo in caso di problemi. In generale, dopo l’aggiunta del repository, ricontrolla la provenienza dei pacchetti con apt policy.

Esempio di flusso tipico, da adattare al repository che scegli davvero:

sudo add-apt-repository ppa:... 
sudo apt update
apt policy qbittorrent
sudo apt install qbittorrent

Qui il punto non è il comando in sé, ma il controllo successivo: se la Candidate arriva dal PPA e non dal repo Ubuntu, sai esattamente quale sorgente stai usando. Se qualcosa non torna, rimuovi il PPA prima di procedere con altri aggiornamenti.

Installazione di qBittorrent su Ubuntu server con Web UI

Su un server senza desktop, qBittorrent serve quasi sempre per il Web UI. In questo caso l’obiettivo non è aprire una finestra, ma avere un demone stabile, un utente dedicato e una porta raggiungibile solo da dove serve. La scelta corretta è installare il pacchetto, configurare il servizio e limitare l’esposizione di rete.

Installa il pacchetto:

sudo apt update
sudo apt install qbittorrent-nox

Il pacchetto qbittorrent-nox è pensato proprio per l’esecuzione senza GUI. Dopo l’installazione, verifica che sia disponibile il binario corretto:

which qbittorrent-nox
qbittorrent-nox --version

Se il tuo obiettivo è gestirlo come servizio, evita di lanciarlo manualmente in una shell aperta. Meglio un’unità systemd dedicata, con utente non privilegiato e directory dati separate dal resto del sistema.

Servizio systemd per qBittorrent-nox

Un’unità minimale può essere utile quando vuoi un avvio automatico al boot e un controllo chiaro dello stato. Prima crea un utente dedicato, se non esiste già:

sudo adduser --system --group --home /var/lib/qbittorrent qbittorrent

Poi crea una directory di configurazione e assegna i permessi corretti:

sudo mkdir -p /var/lib/qbittorrent/.config/qBittorrent
sudo chown -R qbittorrent:qbittorrent /var/lib/qbittorrent

Un esempio di unit file può essere questo:

[Unit]
Description=qBittorrent-nox service
After=network-online.target
Wants=network-online.target

[Service]
User=qbittorrent
Group=qbittorrent
UMask=002
ExecStart=/usr/bin/qbittorrent-nox --webui-port=8080
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

Salvalo in /etc/systemd/system/qbittorrent.service, poi ricarica systemd e avvia il servizio:

sudo systemctl daemon-reload
sudo systemctl enable --now qbittorrent.service
sudo systemctl status qbittorrent.service

Se il servizio non parte, il primo posto da guardare è il journal:

journalctl -u qbittorrent.service -b --no-pager

Qui di solito emergono errori banali ma decisivi: permessi sulla home, porta già occupata, path sbagliato del binario, oppure configurazione Web UI non inizializzabile.

Accesso al Web UI e credenziali iniziali

Per il primo accesso, vai all’indirizzo del server sulla porta configurata, ad esempio http://IP_DEL_SERVER:8080. Le credenziali predefinite dipendono dalla versione e dal pacchetto, quindi non conviene fare affidamento su valori dati per scontati: controlla il prompt iniziale o la documentazione del pacchetto installato. In molti casi l’interfaccia propone un reset o una prima configurazione obbligatoria.

Una volta dentro, cambia subito la password amministrativa e, se il Web UI resta esposto oltre localhost, valuta un proxy inverso con TLS e restrizioni IP. Esporre la porta in chiaro su Internet non è una buona idea: qBittorrent è uno strumento utile, ma non va trattato come se fosse un pannello pubblico.

Se vuoi verificare che la porta sia in ascolto sul server, usa:

ss -ltnp | grep 8080

Se non compare nulla, il servizio non sta ascoltando sulla porta attesa oppure il processo non è partito. Se compare solo su 127.0.0.1, allora l’accesso remoto non è possibile senza proxy o modifica della bind address.

Configurazione pratica: download, cartelle e permessi

qBittorrent lavora bene quando la struttura delle directory è semplice. Se usi il server per download persistenti, separa almeno tre aree: configurazione, download incompleti e download completati. In questo modo riduci il rischio di confondere file temporanei con contenuti finali e semplifichi backup e ripristino.

Un esempio di layout sensato:

/srv/torrents/incomplete
/srv/torrents/complete
/var/lib/qbittorrent/.config/qBittorrent

Crea le directory e assegna i permessi all’utente del servizio:

sudo mkdir -p /srv/torrents/incomplete /srv/torrents/complete
sudo chown -R qbittorrent:qbittorrent /srv/torrents

Nel pannello di qBittorrent imposta queste cartelle come destinazione predefinita. Se i permessi non sono coerenti, il sintomo tipico è il download che resta in errore o si completa ma non riesce a spostare i file. In quel caso il log applicativo e il journal di sistema ti diranno quasi sempre se si tratta di accesso negato o di spazio insufficiente.

Firewall, esposizione rete e hardening minimo

Se il Web UI deve essere accessibile solo dalla LAN o da una VPN, limita la porta con il firewall. Su Ubuntu con UFW, il principio è semplice: apri solo ciò che serve e solo da chi deve davvero raggiungerlo.

sudo ufw allow from 192.168.1.0/24 to any port 8080 proto tcp
sudo ufw status verbose

Se usi un reverse proxy, tieni qBittorrent in ascolto solo su localhost e pubblica all’esterno il proxy con TLS. È la soluzione più pulita per evitare di esporre direttamente l’interfaccia amministrativa. In quel caso, verifica che qBittorrent non ascolti su tutte le interfacce:

ss -ltnp | grep qbittorrent

Da un punto di vista di sicurezza, il minimo indispensabile è questo: aggiornamenti regolari, password robusta, porte ridotte al necessario, e nessuna credenziale lasciata in chiaro in note, ticket o script. Se devi automatizzare, usa variabili d’ambiente protette o un secret manager, non un file appoggiato in home.

Problemi tipici dopo l’installazione

Il primo problema, molto comune, è il pacchetto installato ma l’applicazione non parte. Le cause più probabili sono tre: binario non trovato, conflitto con una vecchia configurazione, oppure servizio che non ha i permessi giusti. Il modo più veloce per falsificare queste ipotesi è controllare il binario, il journal e la presenza di una porta già occupata.

command -v qbittorrent
command -v qbittorrent-nox
journalctl -u qbittorrent.service -b --no-pager
ss -ltnp | grep 8080

Un secondo problema è la Web UI raggiungibile in locale ma non da remoto. Qui il layer da controllare è quasi sempre rete o bind address: il processo ascolta solo su localhost, il firewall blocca la porta, oppure il router non inoltra il traffico se sei dietro NAT. La verifica minima è ss lato server e un test di connessione dal client.

curl -I http://IP_DEL_SERVER:8080

Se la risposta non arriva, non partire dal tuning dell’app: prima chiarisci se il pacchetto è in ascolto, se il firewall lascia passare il traffico e se il proxy, se presente, è configurato correttamente.

Rimozione pulita e rollback

Se hai installato qBittorrent con i repository Ubuntu, la rimozione è lineare:

sudo apt remove qbittorrent
sudo apt autoremove

Se hai creato un servizio systemd dedicato, fermalo e disabilitalo prima di rimuovere i file di unità:

sudo systemctl disable --now qbittorrent.service
sudo rm /etc/systemd/system/qbittorrent.service
sudo systemctl daemon-reload

Per il rollback, la regola è semplice: conserva sempre una copia della unit file e della configurazione prima di toccarla. Se hai modificato il file in /etc/systemd/system/qbittorrent.service, fai prima un backup con timestamp e poi applica le variazioni. Se qualcosa va storto, ripristini il file precedente, ricarichi systemd e riavvii il servizio.

Controllo finale utile dopo ogni installazione o modifica:

systemctl is-active qbittorrent.service
journalctl -u qbittorrent.service -b --no-pager | tail -n 50

Se l’output è active e il journal non mostra errori ricorrenti, il servizio è in uno stato sano. Assunzione: il lettore ha Ubuntu 24.04 o 22.04 aggiornato e può eseguire comandi con privilegi sudo.

Scelta pratica finale

Per un desktop Ubuntu, installa qbittorrent dai repository e basta. Per un server, usa qbittorrent-nox, utente dedicato, servizio systemd e rete limitata. Per chi vuole una release più recente, il PPA va bene solo se sai perché lo stai introducendo e come toglierlo. È la differenza tra un setup che funziona oggi e uno che resta governabile anche tra sei mesi.