# VirtualBox : Installer les outils additionnels sous 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>

# Procédure d’installation
## Installation des prérequis
Mettre à jour le système Debian :
```
sudo apt update && sudo apt upgrade -y
```
Installer les applications nécessaires sur l’OS avant d’installer les outils invités :
```
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é..."
![[_img-kb-ovb-lnx-guest-additions.png]]
Dans la console Shell Debian monter le CD-ROM dans un répertoire de l’OS :
```
sudo mount /dev/cdrom /media/cdrom
```
Se déplacer dans l'arborescence du système avec la commande
```
cd /media/cdrom
```
Lister le contenu du répertoire pour confirmer la présence du fichier `VBoxLinuxAdditions.run` avec la commande
```
ls -lah
```
Exécuter le script d'installation pour Linux avec la commande
```
sudo ./VBoxLinuxAdditions.run
```
Redémarrer la VM
```
sudo reboot
```
Éjecter 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"
![[_img-kb-ovb-lnx-guest-additions-1.png]]