1 17/05/2026 10 min

Su Ubuntu 20.04 il TeamSpeak Client non si installa da repository ufficiali APT come un normale pacchetto .deb: in pratica si scarica l’archivio del client, si estrae in una directory dedicata e si avvia l’eseguibile. È una procedura semplice, ma va fatta con un minimo di ordine per evitare problemi di permessi, integrazione col desktop e aggiornamenti gestiti male.

Qui sotto trovi una procedura pulita, pensata per un sistema desktop Ubuntu 20.04 standard. L’obiettivo è installare il client, creare un lanciatore comodo e verificare che audio, rete e librerie grafiche siano a posto. Se usi una macchina minimale o un ambiente con restrizioni particolari, conviene controllare prima i prerequisiti.

1. Verifica dei prerequisiti

Prima di scaricare il client, controlla di essere su architettura amd64, che la sessione grafica sia funzionante e che il sistema abbia gli strumenti base per decomprimere archivi e gestire download HTTPS.

Apri un terminale e verifica i dettagli essenziali:

uname -m
lsb_release -a
which wget tar xdg-open

Atteso: uname -m deve restituire x86_64 o comunque una piattaforma compatibile con il client che stai scaricando; lsb_release -a deve mostrare Ubuntu 20.04; i comandi wget, tar e xdg-open devono essere presenti nel PATH. Se uno di questi manca, installalo prima di procedere.

Se wget non è installato, puoi usare curl al suo posto. Se nemmeno tar è disponibile, qualcosa non va nel sistema base e conviene sistemarlo prima di toccare applicazioni desktop.

2. Installazione delle dipendenze utili

TeamSpeak Client normalmente parte senza dipendenze strane, ma su Ubuntu 20.04 è prudente installare alcune librerie grafiche e il supporto audio più comune. Questo riduce il rischio di aprire il programma e trovarsi con finestre nere, icone mancanti o problemi di input audio.

Esegui:

sudo apt update
sudo apt install -y libqt5gui5 libqt5widgets5 libqt5network5 libqt5dbus5 libxcb-xinerama0 libasound2

Questi pacchetti coprono i componenti più frequenti su un client Qt in ambiente desktop. Non sempre sono tutti necessari, ma installarli evita una parte dei problemi banali. Se il sistema li ha già, APT non farà danni: si limita a confermare che sono presenti.

Se lavori su una macchina con installazione minimale, può servire anche un backend grafico più completo, ma qui conviene non anticipare problemi che non si sono ancora manifestati. L’approccio corretto è installare il minimo utile e verificare il risultato.

3. Download del TeamSpeak Client

Scarica il client dal sito ufficiale di TeamSpeak. In genere il file è un archivio compresso per Linux, spesso con estensione .run oppure .tar.bz2 a seconda della versione distribuita. Il punto importante non è tanto il nome esatto del file, quanto il fatto che provenga dalla sorgente ufficiale e sia verificabile con hash o firma se pubblicati.

Per esempio, se stai usando un archivio .run, puoi scaricarlo in una directory temporanea:

mkdir -p ~/Downloads/teamspeak-client
cd ~/Downloads/teamspeak-client
wget -O TeamSpeak3-Client.run "URL_UFFICIALE_DEL_FILE"

Se il file è un archivio .tar.bz2, il flusso è simile. In alternativa puoi scaricarlo con il browser, ma da terminale hai più controllo su path e nome del file. Il vantaggio pratico è che sai esattamente dove finisce il pacchetto e puoi ripetere i passaggi senza ambiguità.

Se il sito ufficiale fornisce checksum, verifica sempre il file. In un contesto desktop personale può sembrare un eccesso di zelo, ma su ambienti aziendali o condivisi è una misura minima sensata.

sha256sum TeamSpeak3-Client.run
# confronta l'hash con quello pubblicato sul sito ufficiale

4. Installazione manuale del client

Il modo più pulito è installare il client in una directory dedicata sotto /opt, così separi l’applicazione dai file utente e puoi rimuoverla senza lasciare tracce sparse. È una scelta più ordinata rispetto a estrarre tutto nella home e dimenticarselo lì per anni.

Crea la directory di destinazione e copia lì il file scaricato:

sudo mkdir -p /opt/teamspeak-client
sudo cp ~/Downloads/teamspeak-client/TeamSpeak3-Client.run /opt/teamspeak-client/
sudo chmod +x /opt/teamspeak-client/TeamSpeak3-Client.run

Ora esegui l’installer o estrai l’archivio, in base al formato del pacchetto. Se è un file .run, spesso basta lanciarlo:

cd /opt/teamspeak-client
sudo ./TeamSpeak3-Client.run

Alcuni pacchetti .run si autoestraggono nella directory corrente e poi generano una cartella con binario e file di supporto. Se il pacchetto che hai scaricato funziona così, controlla il contenuto con ls -la dopo l’esecuzione. Se invece il sito distribuisce un archivio .tar.bz2, usa:

sudo tar -xjf TeamSpeak3-Client.tar.bz2 -C /opt/teamspeak-client --strip-components=1

Il parametro --strip-components=1 serve quando l’archivio contiene una directory radice già pronta e vuoi evitare un livello extra di nesting. Se non sei sicuro della struttura dell’archivio, prima ispezionalo con tar -tjf.

tar -tjf TeamSpeak3-Client.tar.bz2 | head

Atteso: vedi i file del client senza errori di decompressione. Se tar segnala archivio corrotto, il download è incompleto e va rifatto. Non ha senso andare avanti con un file rotto sperando che “magicamente” si apra.

5. Avvio del client da terminale

Una volta estratto il client, individua il binario. Nei pacchetti TeamSpeak per Linux il nome può variare leggermente, ma di solito c’è un eseguibile principale nella directory del programma. Usa find per capire cosa hai davanti invece di assumere il nome a memoria.

cd /opt/teamspeak-client
find . -maxdepth 2 -type f -executable

Il comando dovrebbe mostrarti il binario avviabile. Se il client è stato estratto correttamente, puoi lanciarlo direttamente. Esempio:

./ts3client_linux_amd64

Il nome esatto può essere diverso a seconda della versione. Se non lo trovi, controlla la cartella con ls -la e cerca l’eseguibile principale. Una volta avviato, il client dovrebbe aprire la finestra grafica senza errori di librerie mancanti.

Se il programma non parte e il terminale stampa errori tipo error while loading shared libraries, la dipendenza mancante è quasi sempre chiara dal messaggio. In quel caso installa il pacchetto richiesto con APT e rilancia il binario. È meglio correggere la libreria precisa che installare pacchetti a caso.

6. Creazione di un lanciatore nel menu applicazioni

Avviare TeamSpeak dal terminale ogni volta è scomodo. Su Ubuntu 20.04 conviene creare un file desktop in ~/.local/share/applications/, così il client compare nel menu applicazioni come un programma normale.

Crea il file teamspeak-client.desktop:

mkdir -p ~/.local/share/applications
nano ~/.local/share/applications/teamspeak-client.desktop

Inserisci questo contenuto, adattando il percorso del binario se necessario:

[Desktop Entry]
Type=Application
Name=TeamSpeak Client
Comment=Client TeamSpeak per Linux
Exec=/opt/teamspeak-client/ts3client_linux_amd64
Icon=/opt/teamspeak-client/icon.png
Terminal=false
Categories=Network;Chat;InstantMessaging;

Il campo Icon è opzionale ma utile. Se nel pacchetto è presente un’icona in un altro formato o in un altro path, aggiorna il valore. Se non sai dove sia, puoi cercarla con find:

find /opt/teamspeak-client -iname '*.png' -o -iname '*.svg'

Dopo aver salvato il file, rendilo eseguibile:

chmod +x ~/.local/share/applications/teamspeak-client.desktop

Ora puoi cercare “TeamSpeak Client” nel menu di GNOME o dell’ambiente desktop in uso. Se non compare subito, esci e rientra nella sessione oppure aggiorna il database dei launcher con update-desktop-database se presente.

7. Verifica audio, input e rete

TeamSpeak non serve a molto se il microfono non viene visto o il client non riesce a stabilire connessioni in uscita. Dopo il primo avvio controlla subito tre cose: output audio, input microfono e connettività verso il server che vuoi usare.

Dal punto di vista rete, una prova minima è raggiungere il server o almeno verificare che il DNS e la connettività generale funzionino:

ping -c 3 example.com
nslookup example.com

Per l’audio, apri le impostazioni del client e seleziona il dispositivo corretto. Su Ubuntu 20.04 l’audio può passare da PulseAudio o, in alcuni setup, da PipeWire compatibile. Se il microfono non appare, verifica a livello sistema con:

pactl info
pactl list short sources
pactl list short sinks

Se pactl mostra sorgenti e sink ma TeamSpeak non li vede, il problema è quasi sempre lato selezione dispositivo dentro l’app o permessi della sessione grafica. Se invece pactl fallisce, il problema è più a monte e va risolto nell’audio di sistema prima di toccare il client.

8. Aggiornamento del client

Dato che non stai usando un pacchetto APT standard, gli aggiornamenti non arrivano da apt upgrade. Devi sostituire manualmente la directory del client con una nuova versione scaricata dal sito ufficiale. È un limite da conoscere subito, così non ti aspetti aggiornamenti automatici che non esistono.

La procedura corretta è questa: scarichi la nuova release in una directory temporanea, verifichi l’hash, chiudi TeamSpeak, fai un backup della vecchia cartella e poi sostituisci i file. Per esempio:

cp -a /opt/teamspeak-client /opt/teamspeak-client.backup-$(date +%F)
# scarica la nuova versione in ~/Downloads/teamspeak-client/
# estrai nella stessa directory o in una nuova cartella pulita

Questo approccio ti dà un rollback semplice: se la nuova versione non parte, puoi ripristinare la cartella precedente rinominandola di nuovo al suo posto. Non serve inventarsi procedure complicate per un client desktop.

9. Rimozione pulita

Se vuoi disinstallarlo, il vantaggio dell’installazione in /opt è che la rimozione è banale. Prima chiudi il client, poi elimina la directory e il launcher utente. È una procedura reversibile fino all’ultimo secondo, purché tu abbia davvero messo tutto in un posto solo.

rm -rf /opt/teamspeak-client
rm -f ~/.local/share/applications/teamspeak-client.desktop

Prima di eseguire rm -rf, controlla il path con attenzione. È un comando legittimo in questo contesto, ma non va mai lanciato con leggerezza. Se hai dubbi, sostituiscilo con ls -la /opt/teamspeak-client per verificare che la directory sia quella giusta.

10. Problemi comuni e lettura rapida dei sintomi

Se il client non si avvia, il primo controllo è il terminale. L’errore più utile è quasi sempre quello stampato subito dopo il lancio. Una finestra che non compare non significa molto; un messaggio tipo cannot open shared object file invece ti dice già dove intervenire.

Se vedi una schermata bianca o un’interfaccia incompleta, le cause tipiche sono tre: librerie Qt mancanti, problemi di accelerazione grafica o sessione X/Wayland non compatibile con quella build. In questi casi conviene provare a lanciare il client da un terminale dentro una sessione grafica standard, senza container, senza remote desktop e senza modifiche strane al rendering.

Se il microfono funziona in altre applicazioni ma non in TeamSpeak, il problema è quasi sempre una selezione errata del device o la configurazione di input dell’app. Se invece nessuna app sente il microfono, il problema non è TeamSpeak: è l’audio di sistema.

Se il client non riesce a connettersi ai server, verifica firewall, proxy, DNS e porta del server. TeamSpeak usa una connessione TCP/UDP verso il server remoto e un filtro di rete troppo stretto può interrompere tutto anche se il programma si apre correttamente. Il desktop sembra “ok”, ma la parte utile resta bloccata.

11. Procedura compatta consigliata

Se vuoi una versione sintetica della procedura, l’ordine giusto è questo: verifica il sistema, installa le dipendenze utili, scarica il pacchetto ufficiale, estrailo in /opt, avvia il client, crea il launcher desktop e fai una verifica audio/rete. È il flusso più prevedibile e quello che lascia meno residui nel sistema.

  1. Controlla architettura e versione di Ubuntu.
  2. Installa le librerie base con apt.
  3. Scarica il client dal sito ufficiale.
  4. Verifica checksum o firma se disponibile.
  5. Esegui o estrai il client in /opt/teamspeak-client.
  6. Avvialo da terminale e controlla eventuali errori.
  7. Crea il file .desktop per il menu applicazioni.
  8. Testa microfono, output e connessione al server.

Assunzione: il lettore sta usando Ubuntu 20.04 desktop a 64 bit, con accesso sudo e una sessione grafica locale funzionante.