Installare le Guest Additions di VirtualBox su MX Linux KDE

Su MX Linux KDE le Guest Additions di VirtualBox non servono solo a “vedere meglio” la macchina virtuale: abilitano ridimensionamento dinamico, clipboard condivisa, drag and drop, sincronizzazione del mouse e, in molti casi, una gestione più pulita dei driver video. Se l’obiettivo è lavorare in VM senza portarsi dietro finestre scomode o risoluzioni fisse, questa è una di quelle installazioni da fare bene subito.

La parte che crea più problemi non è il pacchetto in sé, ma il contorno: kernel headers mancanti, moduli non compilati, ISO non montata, oppure un mismatch tra kernel in esecuzione e sorgenti installati. Su MX Linux KDE, che deriva dall’ecosistema Debian ma aggiunge i suoi strumenti, conviene procedere con ordine: prima verificare il layer sistema, poi installare i prerequisiti, infine lanciare l’installer delle Guest Additions e controllare i moduli caricati.

Prerequisiti da verificare prima di toccare VirtualBox

Il punto di partenza è semplice: il kernel in esecuzione deve avere i relativi header installati, e la VM deve avere accesso ai tool per compilare i moduli. Senza questi pezzi, l’installer di Oracle parte ma finisce con errori poco utili, spesso dopo aver consumato tempo in messaggi come kernel headers not found o gcc not found.

Controlla subito il kernel attivo e la presenza dei pacchetti base:

uname -r
dpkg -l | egrep 'build-essential|dkms|linux-headers'

Se il primo comando restituisce una versione kernel, quella è la stringa che deve combaciare con gli header installati. Se il secondo comando non mostra almeno build-essential, dkms e gli header del kernel in uso, fermati lì: prima sistema i prerequisiti, poi fai l’installazione delle Guest Additions.

In MX Linux, il modo più lineare è usare MX Package Installer oppure Synaptic. Se preferisci CLI perché stai lavorando da console o in una sessione remota, i pacchetti tipici sono questi:

sudo apt update
sudo apt install build-essential dkms linux-headers-$(uname -r)

Se linux-headers-$(uname -r) non è disponibile, il problema non è VirtualBox: significa che il repository non ha il pacchetto corrispondente al kernel corrente, oppure stai usando un kernel non allineato ai repository configurati. In quel caso conviene aprire il gestore pacchetti e cercare il meta-pacchetto headers corretto, oppure verificare con apt-cache search linux-headers quale ramo è disponibile.

Installare le Guest Additions dal menu di VirtualBox

La via più pulita è usare il menu del virtualizzatore, non scaricare a mano pacchetti sparsi. Avvia la VM MX Linux KDE, accedi al desktop, poi nel menu di VirtualBox scegli Dispositivi e quindi Inserisci l’immagine del CD delle Guest Additions. Questo monta l’ISO ufficiale dentro la macchina virtuale, senza dover cercare file esterni o versioni incoerenti.

Dentro MX Linux, se il montaggio automatico non parte, puoi verificare il device ottico e montarlo manualmente. Prima identifica il punto di mount:

lsblk
mount | grep -i cdrom

Spesso l’ISO appare come un lettore CD/DVD su /dev/sr0. Se il desktop non apre nulla, puoi montarlo così:

sudo mkdir -p /mnt/cdrom
sudo mount /dev/sr0 /mnt/cdrom
ls /mnt/cdrom

Nel contenuto dovresti vedere uno script chiamato VBoxLinuxAdditions.run. È lui che avvia la compilazione dei moduli per il kernel in uso.

Prima di eseguirlo, conviene aprire un terminale e lanciare l’installer con privilegi amministrativi:

sudo sh /mnt/cdrom/VBoxLinuxAdditions.run

Se il mount point è diverso, sostituisci il percorso reale. Durante l’esecuzione, l’output deve mostrare la compilazione dei moduli vboxguest, vboxsf e vboxvideo o equivalenti, a seconda della versione. Un’installazione corretta termina senza errori di compilazione e senza righe che segnalano header mancanti o tool assenti.

Installazione da repository: quando ha senso e quando no

Su alcune distribuzioni Debian-based si preferisce installare i pacchetti guest forniti dai repository: virtualbox-guest-dkms, virtualbox-guest-utils e, se serve l’integrazione grafica, anche i moduli per X11. Su MX Linux KDE questo approccio è utile quando vuoi mantenere tutto allineato con gli aggiornamenti del sistema, soprattutto se il kernel cambia spesso.

La controindicazione è che i pacchetti repository possono non essere perfettamente allineati con la versione di VirtualBox installata sull’host, soprattutto se l’host usa un ramo diverso da quello dei repository. In ambienti controllati, la scelta più robusta resta usare l’ISO inclusa con la versione di VirtualBox dell’host, perché riduce il rischio di mismatch tra guest tools e hypervisor.

Se vuoi verificare cosa è già presente nel sistema, usa:

dpkg -l | grep -i virtualbox

Se trovi già pacchetti guest installati, evita di sovrapporre installazioni diverse senza prima capire quale stack stai usando. Mischiare ISO Oracle e pacchetti distro senza criterio è un modo rapido per ritrovarsi con moduli caricati a metà o servizi che non partono come previsto.

Verifica dei moduli e integrazione con KDE

Una volta completata l’installazione, la verifica non si fa “a occhio”. Bisogna controllare che i moduli siano presenti e attivi nel kernel. Il comando più diretto è questo:

lsmod | grep vbox

In un sistema sano dovresti vedere moduli come vboxguest, vboxsf e, in alcuni casi, vboxvideo. Se non compaiono, guarda il log del servizio DKMS o dell’installer. I punti classici da controllare sono:

journalctl -b | grep -i vbox
cat /var/log/vboxadd-setup.log
cat /var/log/vboxadd-install.log

Su KDE, il beneficio più visibile è il ridimensionamento automatico della finestra e la migliore integrazione del puntatore. Se il desktop resta bloccato su una risoluzione rigida, spesso il problema non è l’installazione in sé ma il fatto che la sessione grafica non abbia caricato il driver corretto o che il server X/Wayland in uso non stia usando la via prevista dalle Guest Additions. In quel caso, verifica la sessione attiva e il display manager.

echo $XDG_SESSION_TYPE
loginctl show-session $(loginctl | awk '/tty|seat/{print $1; exit}') -p Type

Se sei in X11, l’integrazione classica tende a funzionare senza sorprese. Se sei in Wayland, alcune funzioni possono comportarsi in modo diverso a seconda della versione di VirtualBox e del driver video; non è un errore del sistema, è un limite pratico da tenere presente.

Problemi tipici e lettura rapida degli errori

Il caso più comune è l’installazione che sembra partire ma si interrompe con messaggi relativi a gcc, make o header non trovati. Qui la correzione è banale: installa i prerequisiti e rilancia lo script. Se invece il log parla di mismatch tra kernel e moduli, devi verificare che il kernel attivo sia quello per cui hai installato gli header.

Un’altra situazione frequente è la presenza del CD delle Guest Additions nel lettore ma nessun file visibile. In quel caso il mount non è avvenuto o il device è stato associato a un punto sbagliato. Il controllo minimo è:

ls -l /dev/sr0
findmnt /mnt/cdrom
ls /mnt/cdrom/VBoxLinuxAdditions.run

Se il file non esiste, non forzare l’installazione: prima risolvi il mount. Se esiste ma non è eseguibile, lo script si lancia comunque con sh, quindi il bit di esecuzione non è il problema. Se lo script parte ma termina con errori di compilazione, il log è la fonte primaria, non il messaggio a schermo.

Quando la clipboard condivisa non funziona pur avendo i moduli installati, il problema può stare nella configurazione della VM. In VirtualBox controlla che le opzioni relative a Appunti condivisi e Drag and Drop siano abilitate nel menu della macchina virtuale. Se la GUI host le mostra disattivate, la guest non può inventarsele da sola.

Rifinitura post-installazione: servizi, riavvio e ordine operativo

Dopo l’installazione, il riavvio della guest è la scelta più pulita. È il modo più semplice per fare caricare i moduli nel boot e verificare che tutto parta in modo coerente. In alternativa, puoi provare a caricare manualmente i moduli, ma è una verifica, non un sostituto del reboot quando vuoi chiudere il lavoro in modo pulito.

sudo reboot

Dopo il riavvio, ricontrolla i moduli e il comportamento del desktop. Il test pratico è semplice: ridimensiona la finestra della VM, verifica che il desktop segua il cambio, copia un testo tra host e guest se la clipboard è attiva, e osserva se il mouse entra ed esce dalla finestra senza attriti. Se uno di questi punti fallisce, torna ai log prima di cambiare altro.

Un controllo utile è anche la presenza dei servizi di integrazione, quando esposti come unità o script di avvio. Non tutte le versioni li presentano allo stesso modo, ma il principio è sempre lo stesso: c’è un componente di bootstrap che deve completare l’integrazione kernel-userland. Se il sistema usa DKMS, la ricompilazione al cambio kernel è il segnale che hai scelto la strada giusta per una VM che verrà aggiornata nel tempo.

Quando conviene fermarsi e non forzare

Se la guest è usata per lavoro e l’ambiente è delicato, evita di “sistemare” a colpi di tentativi casuali. Prima raccogli un minimo di evidenza: versione kernel, pacchetti installati, log dell’installer e stato dei moduli. Questo ti permette di distinguere un problema di prerequisiti da un problema di compatibilità, senza bruciare tempo su ipotesi sbagliate.

In sintesi operativa: installa headers e tool, monta l’ISO delle Guest Additions, esegui lo script, verifica i moduli, riavvia e controlla l’integrazione grafica. È una sequenza semplice, ma se salti il controllo del kernel o il log dell’installazione finisci quasi sempre a inseguire sintomi invece della causa.

Assunzione operativa: la macchina MX Linux KDE è una guest VirtualBox aggiornata su kernel supportato dai repository, con accesso sudo e sessione grafica locale disponibile.