# VirtualBox : Installer les outils additionnels sous Debian
#theme/IT/Virtu/OVB #theme/IT/LNX/Debian
Cet article présente une procédure simplifiée de l’installation des **outils additionnels invités** sous VirtualBox pour un OS invité **Debian**. La procédure est disponible au format vidéo ou au format texte.
> [!info] À savoir !<span style="font-weight: normal; color: var(--text-normal)"> Une VM dispose de composants matériels virtuels spécifiques. Les outils additionnels permettent l'installation des **drivers**, améliorent les **performances** et l’**interopérabilité** entre la VM et son hyperviseur.</span>
> [!danger] Attention !<span style="font-weight: normal; color: var(--text-normal)"> Il faut toujours installer les outils additionnels invités, si possible au premier démarrage, pour limiter les dysfonctionnements et assurer la stabilité de la VM.</span>
1. Visionnez la [démonstration vidéo](https://youtu.be/R3-ALuZLRiM)
2. Suivez les étapes à l'aide des commandes ci-dessous.
## Installation des prérequis
Mettre à jour le système Debian :
```shell
sudo apt update && sudo apt upgrade -y
```
Installer les applications nécessaires sur l’OS avant d’installer les outils invités :
```shell
sudo apt install make gcc dkms linux-source linux-headers-$(uname -r) -y
```
## Installation des outils additionnels invités
Dans VirtualBox, ouvrir la console de la VM, cliquer sur "Périphérique > Insérer l'image CD des Additions invité..."
![[_png-kb-ovb-vm-guest-additions-debian.png]]
Dans la console Shell Debian monter le CD-ROM dans un répertoire de l’OS :
```shell
sudo mount /dev/cdrom /media/cdrom
```
Se déplacer dans l'arborescence du système avec la commande
```shell
cd /media/cdrom
```
Lister le contenu du répertoire pour confirmer la présence du fichier `VBoxLinuxAdditions.run` avec la commande
```shell
ls -lah
```
Exécuter le script d'installation pour Linux avec la commande
```shell
sudo ./VBoxLinuxAdditions.run
```
Redémarrer la VM
```shell
sudo reboot
```
Pour confirmer l’installation et la bonne exécution des outils d’intégration utiliser la commande :
```shell
sudo lsmod |grep vboxguest
```
La commande devrait produire un résultat similaire à cela :
![[_png-kb-ovb-vm-guest-additions-debian-1.png]]
Pour finir, éjectez le périphérique "Additions Invités..." depuis la console de la VM : cliquer sur "Périphérique > Lecteur optiques > Remove Disk From Virtual Drive"
![[_png-kb-ovb-vm-guest-additions-debian-2.png]]
## Démonstration d’installation
Vous pouvez visionner la démonstration complète dans la vidéo ci-dessous :
