Come installare Latte Dock su Ubuntu 20.04 e 18.04 LTS

Verifica prima che il desktop sia davvero Plasma

Latte Dock non è un dock generico per qualunque ambiente grafico: nasce per KDE Plasma e sfrutta componenti che in altri desktop non hanno senso o non sono disponibili. Su Ubuntu 20.04 e 18.04 LTS il punto di partenza non è il pacchetto, ma la sessione in uso. Se stai lavorando in GNOME, Xfce o in una sessione remota minimale, puoi anche installare il software, ma l’esperienza sarà incompleta o instabile.

Controlla la sessione attiva con un comando semplice:

echo $XDG_CURRENT_DESKTOP

Se il risultato contiene KDE o Plasma, sei nel contesto giusto. Se invece vedi altro, prima di toccare il dock devi chiarire il desktop target. Su Ubuntu 18.04 e 20.04 il modo più pulito è accedere a una sessione Plasma dal display manager, non cercare di “forzare” Latte dentro un ambiente diverso.

Perché il percorso cambia tra 18.04 e 20.04

La differenza pratica tra le due LTS non è solo nel numero di versione. Cambiano i repository disponibili, la versione di Plasma, e in alcuni casi la freschezza dei pacchetti nei mirror standard. Su 20.04 il supporto a Plasma è generalmente più lineare; su 18.04 capita più spesso di dover aggiungere un repository esterno oppure di trovare versioni meno aggiornate nei canali base.

Il punto da non perdere è questo: installare Latte Dock non significa solo copiare un binario. Devi avere una sessione Plasma coerente, una versione di Qt/PDE compatibile e un avvio che non venga sovrascritto da configurazioni utente precedenti. Se il dock parte e poi sparisce, il problema spesso è nella sessione o nel profilo utente, non nell’installazione in sé.

Installazione su Ubuntu 20.04 LTS

Su 20.04 la prima verifica è vedere se il pacchetto è disponibile nei repository abilitati. Aggiorna l’indice e cerca il nome esatto:

sudo apt update
apt-cache policy latte-dock

Se il pacchetto compare con una candidate version, puoi procedere direttamente:

sudo apt install latte-dock

Se invece non trovi nulla o la versione è vecchia, la strada più pulita è abilitare il repository KDE/Plasma adatto al tuo setup. Qui però serve disciplina: prima controlla cosa hai già, poi aggiungi solo il necessario. Un errore comune è mescolare repository di release diverse e portarsi dietro dipendenze incoerenti.

Dopo l’installazione, avvia Latte Dock dalla sessione grafica o dal launcher. In alternativa puoi testarlo da terminale nella stessa sessione Plasma:

latte-dock

Se il comando restituisce errori, guarda subito l’output nel terminale: spesso indica plugin mancanti, problemi con la sessione Wayland/X11 o conflitti con configurazioni precedenti.

Installazione su Ubuntu 18.04 LTS

Su 18.04 la situazione è più delicata, perché il ciclo di vita della distribuzione e la disponibilità dei pacchetti possono essere più stretti. Prima di tutto aggiorna i riferimenti e verifica la presenza del pacchetto:

sudo apt update
apt-cache policy latte-dock

Se il pacchetto non è disponibile o la versione è troppo datata, puoi dover ricorrere a un repository KDE dedicato. In quel caso il criterio è sempre lo stesso: aggiungi una sorgente affidabile, aggiorna, installa e poi verifica che non ci siano dipendenze spezzate.

Se usi un PPA o un repository esterno, tieni presente il rischio operativo: stai aumentando la superficie di aggiornamento del sistema. Il rollback deve essere noto prima di cambiare qualcosa. In pratica significa sapere quale sorgente hai aggiunto e come rimuoverla se il sistema inizia a comportarsi male.

Una volta installato, lancia il dock e osserva se parte senza errori:

latte-dock --debug

Se l’opzione di debug è supportata dalla build installata, aiuta a capire se il problema è nel caricamento dei plasmoidi, nella sessione grafica o nella configurazione salvata nel profilo utente.

Repository, dipendenze e coerenza del sistema

La parte più sottovalutata non è l’installazione, ma la coerenza delle dipendenze. Latte Dock vive nel mondo KDE: se il sistema ha componenti Plasma parziali, pacchetti rimossi a mano o repository misti, l’effetto può essere un dock che si apre e si chiude, oppure un’interfaccia che non mantiene le impostazioni.

Per capire lo stato del sistema, controlla i pacchetti installati legati a Plasma e Qt:

dpkg -l | egrep 'latte-dock|plasma|kde|qt5'

Il comando non ti dice tutto, ma ti fa vedere subito se stai lavorando su un desktop KDE completo o su un’installazione ibrida. Se mancano componenti fondamentali, conviene sistemare il desktop prima di insistere sul dock.

Se vuoi una verifica più orientata ai problemi di dipendenza, usa:

sudo apt -f install

Questo non è un comando da usare “a sentimento”, ma è utile quando l’installazione ha lasciato il sistema in stato incompleto. Se il sistema propone rimozioni o sostituzioni anomale, fermati e valuta il pacchetto che ha rotto la catena.

Avvio automatico e persistenza della configurazione

Su Plasma, Latte Dock tende a integrarsi con la sessione utente, ma l’avvio automatico non va dato per scontato. Se il dock parte solo manualmente, verifica che la voce sia presente tra le applicazioni all’avvio o che il profilo utente non abbia una configurazione corrotta.

Il controllo rapido è lato file utente. Cerca eventuali voci di autostart:

ls ~/.config/autostart/
cat ~/.config/autostart/*.desktop 2>/dev/null

Se trovi un file desktop relativo a Latte, controlla che il comando puntato sia corretto e che non stia richiamando un binario vecchio. In caso di dubbi, rimuovi solo la voce di avvio automatico e rilancia il dock manualmente per isolare il problema. Questo approccio limita il blast radius: tocchi la sessione dell’utente, non il sistema intero.

La configurazione principale, se presente, sta nel profilo utente. In ambiente KDE è normale vedere file sotto ~/.config/. Prima di fare modifiche invasive, fai un backup dei file interessati:

cp -a ~/.config/latte* ~/.config/latte.backup.$(date +%F) 2>/dev/null

Se il prefisso non esiste, non forzare: vuol dire che la versione installata usa un layout diverso o che il profilo non è ancora stato creato.

Come capire se il problema è della sessione grafica

Molti errori attribuiti a Latte Dock sono in realtà errori della sessione Plasma. Se il dock non compare, si pianta all’avvio o non salva le impostazioni, verifica il tipo di sessione e i log utente.

Un controllo utile è questo:

loginctl show-session $XDG_SESSION_ID -p Type -p Desktop

Se il tipo è x11 o wayland, annotalo: alcune combinazioni di Plasma, driver grafici e versioni di Ubuntu si comportano in modo diverso. Se il problema compare solo su Wayland, prova una sessione X11 prima di inseguire bug inesistenti nel dock.

Per i log utente, il punto di partenza è il journal della sessione:

journalctl --user -b | grep -i latte

Se non esce nulla, allarga la ricerca a Plasma e Qt. Il valore qui non è solo l’errore, ma il momento in cui compare: all’avvio, al salvataggio del layout, al caricamento di un plasmoide o durante il restore della sessione.

Risoluzione dei casi più comuni

Il caso più semplice è il pacchetto non trovato. In quel caso la soluzione non è cercare mirror casuali, ma verificare quali sorgenti hai abilitato e se il tuo Ubuntu è ancora in una condizione supportata per quel repository. Se il pacchetto esiste ma non installa, il problema è quasi sempre una dipendenza mancante o un conflitto tra versioni.

Un secondo caso frequente è il dock che si avvia ma non resta visibile. Qui le ipotesi più probabili sono tre: configurazione utente corrotta, sessione grafica non coerente, oppure conflitto con un altro dock o pannello. Per falsificarle velocemente:

1. Rinomina temporaneamente la configurazione utente di Latte e riprova l’avvio.
2. Passa da Wayland a X11 o viceversa e verifica se il comportamento cambia.
3. Disabilita altri dock/pannelli di terze parti e controlla se Latte compare correttamente.

Un terzo caso è il crash all’avvio. In questo scenario il terminale e il journal sono più utili della GUI. Se il processo termina subito, guarda l’ultimo messaggio di errore e verifica se cita librerie, plasmoidi o file di configurazione non leggibili. Quando il messaggio fa riferimento a un file nel profilo utente, il fix spesso è pulire la configurazione locale e ricrearla da zero.

Ripristino pulito senza rompere il profilo utente

Se vuoi fare una pulizia minima e reversibile, lavora per rinomina, non per cancellazione. È il metodo più sicuro per testare senza perdere dati:

mv ~/.config/latte* ~/.config/latte.disabled.$(date +%F) 2>/dev/null

Dopo il rename, riavvia la sessione grafica o rilancia Latte Dock. Se il problema sparisce, hai isolato la causa nel profilo locale. A quel punto puoi ricostruire la configurazione con calma, invece di trascinarti dietro un file difettoso.

Se il problema invece resta identico, la causa è più a monte: dipendenze, sessione, repository o integrazione con Plasma. In quel caso non ha senso insistere sulla configurazione utente, perché non stai colpendo il layer giusto.

Versioni, compatibilità e aspettative realistiche

Su Ubuntu 20.04 Latte Dock tende a essere più lineare da installare e mantenere, soprattutto se la sessione Plasma è aggiornata e i repository sono puliti. Su 18.04 il margine di attrito è più alto: repository meno freschi, componenti grafici più vecchi e più probabilità di trovare un sistema “mezzo KDE” costruito nel tempo.

La regola pratica è semplice: se il desktop è già Plasma, Latte Dock è un’aggiunta sensata. Se il desktop non è Plasma, stai introducendo un pezzo che dipende da un ecosistema che non hai ancora. In quel caso la soluzione corretta non è installare il dock e sperare, ma decidere se vuoi davvero adottare KDE oppure se ti conviene un dock più coerente con il desktop esistente.

Un’ultima nota operativa: se stai documentando l’installazione per altri utenti, specifica sempre la release di Ubuntu, il tipo di sessione e la provenienza dei pacchetti. Senza questi tre dati, una procedura “funzionante” su una macchina può fallire in modo banale su un’altra.

Checklist finale prima di dare per buona l’installazione

1. La sessione è Plasma e non un desktop diverso.
2. apt-cache policy latte-dock mostra una candidate version installabile.
3. latte-dock parte senza errori evidenti nel terminale.
4. Le voci di autostart e i file in ~/.config/ non puntano a binari obsoleti.
5. Se hai aggiunto repository esterni, sai già come rimuoverli se serve il rollback.

Assunzioni: Ubuntu 18.04 e 20.04 con accesso amministrativo, sessione grafica locale o remota ma compatibile con Plasma, e nessun vincolo aziendale che blocchi repository esterni.