Introduzione

Distrobox è un wrapper per Docker, Lilipod e Podman (di default usa quest'ultimo, che consente utilizzo di contenitori come utente non root).
Attraverso l'utilizzo di container non isolati dall'host, questo strumento consente di eseguire più distribuzioni GNU/Linux sullo stesso sistema in modo semplice ed efficace.
Distrobox integra anche strumenti per la condivisione di file e risorse tra l'host e i contenitori, offrendo grande flessibilità: i container così creati saranno strettamente integrati col sistema host, avendo accesso al kernel (compresi driver e moduli), ai processi, alla HOME dell'utente, all'hardware, ai drive interni ed esterni, alle applicazioni grafiche (sia con X11 che Wayland) e all'audio.

Distrobox, quindi, facilita l'installazione e la gestione di diverse distribuzioni, senza richiedere sistemi virtualizzati, partizioni separate e configurazioni complesse. Gli utenti possono così eseguire, testare o sviluppare applicazioni in un ambiente isolato, beneficiando delle funzionalità native di ciascuna distribuzione, oppure utilizzando versioni e/o librerie più o meno recenti (senza far ricorso a Snap, Flatpak e AppImage).
È rilasciato con licenza GPL v3.0.

Installazione

Da repository

Installare il pacchetto distrobox.

Distrobox è presente nei repository ufficiali delle seguenti versioni di Ubuntu:

Per altre versioni di Ubuntu o per ottenere l'ultima versione di Distrobox, utilizzare il metodo da script.

Tramite script

La versione più recente dell'applicazione può essere installata/disinstallata direttamente tramite uno script, con l'uso limitato all'utente comune o disponibile all'intero sistema tramite l'utente amministratore.

• Utente comune:

  • Per installare digitare nel terminale il seguente comando:

    wget -qO- https://raw.githubusercontent.com/89luca89/distrobox/main/install | sh

  • Per disinstallare digitare nel terminale il seguente comando:

    wget -qO- https://raw.githubusercontent.com/89luca89/distrobox/main/uninstall | sh

• Utente amministratore:

  • Per installare digitare nel terminale il seguente comando:

    wget -qO- https://raw.githubusercontent.com/89luca89/distrobox/main/install | sudo sh

  • Per disinstallare digitare nel terminale il seguente comando:

    wget -qO- https://raw.githubusercontent.com/89luca89/distrobox/main/uninstall | sudo sh

Utilizzo

Comandi di base

Di seguito sono elencati i comandi di base (senza tutte le opzioni) e le relative descrizioni:

Per maggiori dettagli su come utilizzare i comandi, consultare la documentazione ufficiale.

Esempio 1: creazione di un contenitore Ubuntu

In questo esempio, l'host è Ubuntu 24.04:

user@desktop:~$ cat /etc/os-release | grep VERSION
VERSION_ID="24.04"
VERSION="24.04.2 LTS (Noble Numbat)"
VERSION_CODENAME=noble

Scegliere il guest tra le seguenti immagini di contenitori. Altre sono disponibili seguendo i link di questa pagina.
In sostanza, per un contenitore Ubuntu abbiamo le seguenti scelte:

• Per creare un contenitore standard, chiamato Ubuntu2504 e basato su un'immagine docker ubuntu:25.04, digitare nel terminale il comando:

  distrobox-create --name Ubuntu2504 --image ubuntu:25.04

  Tuttavia, è preferibile creare contenitori di sistema (in cui il contenitore si comporta in modo più simile a una macchina virtuale completa che a un contenitore di applicazioni) utilizzando il parametro --init. All'interno si avranno un init separato, una sessione utente, demoni e così via. Cioè, aggiungendo --init --additional-packages "systemd libpam-systemd" al comando precedente:

  user@desktop:~$ distrobox-create --name Ubuntu2504 --image ubuntu:25.04 --init --additional-packages "systemd libpam-systemd"
  Image ubuntu:25.04 not found.
  Do you want to pull the image now? [Y/n]: 
  Resolved "ubuntu" as an alias (/etc/containers/registries.conf.d/shortnames.conf)
  Trying to pull docker.io/library/ubuntu:25.04...
  Getting image source signatures
  Copying blob 1b3c8f62d074 done   | 
  Copying config f51757c148 done   | 
  Writing manifest to image destination
  f51757c148c75f97fd1c48fb6b21ac37bd5108e91e4b1d528d5e62827cf76a36
  Creating 'Ubuntu2504' using image ubuntu:25.04   [ OK ]
  Distrobox 'Ubuntu2504' successfully created.
  To enter, run:
  
  distrobox enter Ubuntu2504
  user@desktop:~$

• Per entrare nel contenitore:

  user@desktop:~$ distrobox enter Ubuntu2504
  Starting container...                            [ OK ]
  Installing basic packages...                     [ OK ]
  Setting up devpts mounts...                      [ OK ]
  Setting up read-only mounts...                   [ OK ]
  Setting up read-write mounts...                  [ OK ]
  Setting up host's sockets integration...         [ OK ]
  Integrating host's themes, icons, fonts...       [ OK ]
  Setting up distrobox profile...                  [ OK ]
  Setting up sudo...                               [ OK ]
  Setting up user groups...                        [ OK ]
  Setting up kerberos integration...               [ OK ]
  Setting up user's group list...                  [ OK ]
  Setting up existing user...                      [ OK ]
  Setting up user home...                          [ OK ]
  Ensuring user's access...                        [ OK ]
  Setting up init system...                        [ OK ]
  Firing up init system...                         [ OK ]
  
  Container Setup Complete!
  user@Ubuntu2504:~$ 

  Si noti che ci si trova all'interno del contenitore poiché il testo alla sinistra del simbolo $ è cambiato diventando: NOME_UTENTE@NOME_CONTENITORE.

• Per visualizzare la versione, al fine di confermare che è in uso il contenitore Ubuntu 25.04:

  user@Ubuntu2504:~$ cat /etc/os-release | grep VERSION
  VERSION_ID="25.04"
  VERSION="25.04 (Plucky Puffin)"
  VERSION_CODENAME=plucky

• Sarà quindi possibile eseguire le normali operazioni di aggiornamento con sudo apt update e sudo apt full-upgrade e poi cambiare la lingua predefinita in italiano:

  sudo apt install language-pack-it

  Qualora il pacchetto language-pack-it-base non venisse installato automaticamente come dipendenza, installarlo con:

  sudo apt install language-pack-it-base

  Generare i file di lingua:

  sudo locale-gen it_IT.UTF-8

  Si deve quindi modificare un file di configurazione. A tal fine si può usare l'editor di testo nano già installato; tuttavia, per una maggiore facilità d'utilizzo, di seguito sarà usato l'editor micro:

  sudo apt install micro
  sudo micro /etc/default/locale

  Modificare il file in modo da avere le seguenti 3 righe:

  LANG=it_IT.UTF-8
  LANGUAGE=it_IT:it
  LC_ALL=it_IT.UTF-8

  Salvare il file (Ctrl-S), uscire (Ctrl-Q), e in fine digitare:

  source /etc/default/locale

  In caso di errore con l'ultimo comando, uscire dal contenitore con logout e poi rientrare con distrobox enter Ubuntu2504.

• È adesso possibile installare una versione più recente di un'applicazione. Ad esempio installando Gimp è presente la versione deb più recente:

  user@Ubuntu2504:~$ dpkg -l | grep gimp
  ii  gimp    3.0.2-1 

  mentre sull'host l'ultima versione nei repository è la 2.10.36.
  
  Per creare un lanciatore sul desktop host, digitare:

  distrobox-export --app gimp

Esempio 2: creazione di un contenitore Void Linux

In questo caso, con lo stesso host dell'esempio precedente, verrà creato un contenitore di una distribuzione rolling, sfruttando così il vantaggio di avere software sempre disponibile nella versione più recente.
Verrà presa a titolo di esempio la distribuzione Void con la seguente immagine: ghcr.io/void-linux/void-glibc-full:latest. Si potrà perciò utilizzare il sistema in modo completamente diverso da Ubuntu, ossia con gli strumenti tipici della distribuzione guest (shell, set di applicazioni, specifici comandi, formato e gestore di pacchetti, repository ecc.).

• Di seguito la sequenza di ordini nel terminale:

  user@desktop:~$ distrobox-create --init --name VoidLinux --image ghcr.io/void-linux/void-glibc-full:latest
  Image ghcr.io/void-linux/void-glibc-full:latest not found.
  Do you want to pull the image now? [Y/n]: 
  Trying to pull ghcr.io/void-linux/void-glibc-full:latest...
  Getting image source signatures
  Copying blob c219f699057e done   | 
  Copying blob 51d9f963312e done   | 
  Copying config 6a34e6fe4a done   | 
  Writing manifest to image destination
  6a34e6fe4aacf1d8bffdbcb2bd20acf00425dacc723f775dac75812a478ecbda
  Creating 'VoidLinux' using image ghcr.io/void-linux/void-glibc-full:latest       [ OK ]
  Distrobox 'VoidLinux' successfully created.
  To enter, run:
  
  distrobox enter VoidLinux
  user@desktop:~$

• Per entrare nel contenitore:

  user@desktop:~$ distrobox enter VoidLinux
  Starting container...                            [ OK ]
  Installing basic packages...                     [ OK ]
  Setting up devpts mounts...                      [ OK ]
  Setting up read-only mounts...                   [ OK ]
  Setting up read-write mounts...                  [ OK ]
  Setting up host's sockets integration...         [ OK ]
  Integrating host's themes, icons, fonts...       [ OK ]
  Setting up distrobox profile...                  [ OK ]
  Setting up sudo...                               [ OK ]
  Setting up user groups...                        [ OK ]
  Setting up kerberos integration...               [ OK ]
  Setting up user's group list...                  [ OK ]
  Setting up existing user...                      [ OK ]
  Setting up user home...                          [ OK ]
  Ensuring user's access...                        [ OK ]
  Setting up init system...                        [ OK ]
  Firing up init system...                         [ OK ]
  
  Container Setup Complete!
  user@VoidLinux:~$

  Si noti che ci si trova all'interno del contenitore poiché il testo alla sinistra del simbolo $ è cambiato diventando: NOME_UTENTE@NOME_CONTENITORE.

• Per visualizzare la versione, al fine di confermare che si è su Void Linux:

  user@VoidLinux:~$ cat /etc/os-release
  NAME="Void"
  ID="void"
  PRETTY_NAME="Void Linux"
  HOME_URL="https://voidlinux.org/"
  DOCUMENTATION_URL="https://docs.voidlinux.org/"
  LOGO="void-logo"
  ANSI_COLOR="0;38;2;71;128;97"
  DISTRIB_ID="void"

• Eseguire le normali operazioni di aggiornamento:

  sudo xbps-install -Su

• Controllare la versione di Gimp disponibile nel sistema guest (nei repository del sistema host la versione è la 2.10.36):

  user@VoidLinux:~$ sudo xbps-query -Rs gimp
  [-] gimp-3.0.2_1                    GNU image manipulation program
  [-] gimp-devel-3.0.2_1              GNU image manipulation program - development files
  [-] gmic-gimp-3.5.3_1               GREYC's Magic for Image Computing (image processing framework) - GIMP plugin
  [-] gtk4-4.18.4_1                   GIMP ToolKit (v4)
  [-] gtk4-demo-4.18.4_1              GIMP ToolKit (v4) - demonstration application
  [-] gtk4-devel-4.18.4_1             GIMP ToolKit (v4) - development files
  [-] gtk4-doc-4.18.4_1               GIMP ToolKit (v4) - documentation
  [-] gtk4-update-icon-cache-4.18.4_1 GIMP ToolKit (v4) - GTK4 update icon cache tool
  [-] libgimp-3.0.2_1    

• Per l'installazione grafica di Gimp:

  • Da riga di comando:

    sudo xbps-install -S gimp

  • Tramite un gestore di pacchetti:

    1. Installare un gestore di pacchetti con interfaccia grafica:

       sudo xbps-install -S octoxbps

    2. Avviare il gestore di pacchetti e procedere con l'installazione:

       octoxbps

       Verrà visualizzato il gestore di pacchetti grafico:

  
  

• Creare i lanciatori sul desktop host:

  distrobox-export --app gimp
  distrobox-export --app octoxbps

Interfaccia grafica

Distrobox può essere utilizzato tramite un'interfaccia grafica con l'applicazione BoxBuddy.
Per maggiori informazioni consultare la pagina del progetto.

Ulteriori risorse

• Sito ufficiale

• Distrobox su Github

• BoxBuddy su Flathub

---

CategoryVirtualizzazione