Docker install Debian : Tuto complet

Installer Docker sur Debian est une opération courante pour les développeurs et les administrateurs système souhaitant créer, déployer et gérer des applications dans des conteneurs. Cet article aborde les étapes d’installation ainsi que les erreurs fréquentes à éviter, afin de vous assurer une mise en place réussie de Docker.

Prérequis avant l’installation

Avant d’installer Docker, assurez-vous que votre système Debian est à jour. Exécutez les commandes suivantes pour mettre à jour vos paquets :

sudo apt update
sudo apt upgrade -y

Vérifiez également que votre version de Debian est compatible avec Docker. Les versions supportées incluent Debian 10 (Buster) et Debian 11 (Bullseye).

Étape 1 : Installation des dépendances

Docker nécessite certaines dépendances pour fonctionner correctement. Exécutez la commande suivante :

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y

Étape 2 : Ajout de la clé GPG de Docker

Pour garantir l’intégrité des paquets, ajoutez la clé GPG officielle de Docker :

curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -

Étape 3 : Ajout du dépôt Docker

Ajoutez le dépôt officiel de Docker à votre liste de sources :

echo "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list

Étape 4 : Installation de Docker

Mettez à jour à nouveau vos paquets puis installez Docker :

sudo apt update
sudo apt install docker-ce -y

Vérification de l’installation

Une fois l’installation terminée, vérifiez que Docker fonctionne correctement en exécutant :

sudo systemctl status docker

Vous devriez voir un message indiquant que le service Docker est actif.

Erreurs fréquentes lors de l’installation

Dépôt non trouvé : Si vous recevez un message d’erreur indiquant que le dépôt n’est pas trouvé, vérifiez la syntaxe de la commande d’ajout du dépôt. Assurez-vous que $(lsb_release -cs) renvoie bien le nom de votre version Debian.
Problèmes avec les dépendances : Il peut arriver que certaines dépendances ne soient pas satisfaites. Dans ce cas, assurez-vous que votre système est bien mis à jour et essayez d’exécuter apt --fix-broken install.
Permissions insuffisantes : Si vous rencontrez des problèmes liés aux permissions lors du démarrage ou de l’utilisation de Docker, il est conseillé d’ajouter votre utilisateur au groupe docker :

bash sudo usermod -aG docker $USER

Déconnectez-vous puis reconnectez-vous pour appliquer les modifications.

Tableau récapitulatif des commandes essentielles

Action	Commande
Mettre à jour les paquets	`sudo apt update && sudo apt upgrade -y`
Installer les dépendances	`sudo apt install apt-transport-https ca-certificates curl ...`
Ajouter la clé GPG	`curl -fsSL https://download.docker.com/linux/debian/gpg \| sudo ...`
Ajouter le dépôt	`echo "deb [arch=amd64] https://... \| sudo tee ...`
Installer Docker	`sudo apt install docker-ce -y`

Piège à éviter

Un piège courant lors de l’installation est d’utiliser une version obsolète ou incompatible de Debian. Avant toute installation, vérifiez toujours la compatibilité des versions sur le site officiel de Docker.

Action immédiate

Pour vous familiariser avec Docker après son installation, exécutez un conteneur test avec la commande suivante :

docker run hello-world

Cette commande téléchargera une image test et exécutera un conteneur qui affichera un message confirmant que votre installation fonctionne correctement.

FAQ #

Quelle version de Debian est compatible avec Docker ?

Docker supporte principalement Debian 10 (Buster) et Debian 11 (Bullseye).

Comment résoudre les problèmes liés aux permissions avec Docker ?

Ajoutez votre utilisateur au groupe docker en utilisant la commande sudo usermod -aG docker $USER, puis reconnectez-vous.

Est-il nécessaire d’installer des dépendances avant d’installer Docker ?

Oui, certaines dépendances doivent être installées pour assurer une bonne configuration avant l’installation de Docker.

Que faire si le service Docker ne démarre pas ?

Vérifiez le statut du service avec systemctl status docker. Si le service ne démarre pas, examinez les logs avec journalctl -u docker.

Comment désinstaller Docker sur Debian ?

Utilisez la commande suivante pour désinstaller complètement Docker :

sudo apt remove --purge docker-ce docker-ce-cli containerd.io

Avec ces étapes et conseils pratiques, vous êtes désormais prêt à installer et utiliser Docker sur votre système Debian sans encombre.