🎯 TUTORIEL PAS À PAS

🐳 Installation de Docker et Portainer sur Debian 13

📅 Mis à jour : Août 2026 ⏱️ Durée : 15-20 min 📋 Niveau : Débutant / Intermédiaire 🐧 Debian 13 🐳 Docker 📦 Portainer

Ce tutoriel vous guide pas à pas dans l'installation de Docker Engine sur Debian 13, la découverte des commandes essentielles, puis l'installation de Portainer CE pour gérer vos conteneurs depuis une interface web.

📌 Prérequis :

Un serveur ou une VM sous Debian 13 (Trixie).
Un accès root ou un utilisateur avec les droits sudo.
Une connexion Internet fonctionnelle.

1 Installation de Docker Engine

Étape 1 – Mise à jour du système

Avant toute installation, assurez-vous que votre système est à jour.

$ sudo apt update && sudo apt upgrade -y

Étape 2 – Installation des dépendances

Installez les paquets nécessaires pour permettre l'installation via apt avec HTTPS.

$ sudo apt install -y ca-certificates curl

Étape 3 – Téléchargement et exécution du script officiel

Docker fournit un script d'installation officiel qui détecte automatiquement votre distribution et installe la version adaptée.

$ curl -fsSL https://get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh

🔍 À savoir : Ce script télécharge et exécute l'installation de Docker Engine, configure le service systemd et ajoute les dépôts officiels.

Étape 4 – Ajout de l'utilisateur au groupe docker

Pour éviter d'utiliser sudo à chaque commande, ajoutez votre utilisateur au groupe docker.

$ sudo usermod -aG docker $USER

⚠️ Important : Vous devez vous déconnecter et vous reconnecter (ou redémarrer la session) pour que ce changement soit effectif.

Étape 5 – Vérification de l'installation

Vérifiez que Docker est bien installé et fonctionnel.

$ docker --version

✅ Exemple de sortie : Docker version 28.0.1, build ...

$ docker run hello-world

✅ Si tout fonctionne, vous verrez un message de bienvenue de Docker.

2 Commandes essentielles Docker

Voici les commandes Docker les plus utilisées. Gardez-les à portée de main !

Commande	Description
docker pull <image>	Télécharge une image depuis un registre (ex: Docker Hub).
docker images	Liste les images téléchargées localement.
docker run <image>	Crée et démarre un conteneur à partir d'une image.
docker ps	Liste les conteneurs en cours d'exécution.
docker ps -a	Liste tous les conteneurs (y compris arrêtés).
docker stop <conteneur>	Arrête un conteneur en cours d'exécution.
docker rm <conteneur>	Supprime un conteneur arrêté.
docker rmi <image>	Supprime une image.
docker logs <conteneur>	Affiche les logs d'un conteneur.
docker exec -it <conteneur> bash	Ouvre un shell interactif dans un conteneur en cours d'exécution.

💡 Astuce : Utilisez docker run --rm pour que le conteneur soit automatiquement supprimé après son arrêt (idéal pour les tests).

Exemple pratique – Nginx

# Télécharger l'image Nginx
$ docker pull nginx:latest

# Lancer un conteneur Nginx sur le port 8080
$ docker run -d --name mon-nginx -p 8080:80 nginx

# Vérifier que le conteneur tourne
$ docker ps

# Accéder au site sur http://localhost:8080

3 Installation de Portainer CE

Portainer Community Edition (CE) est une interface web open-source qui simplifie la gestion des conteneurs Docker.

Étape 1 – Création d'un volume persistent

Portainer stocke ses données (configurations, utilisateurs) dans un volume Docker pour les rendre persistantes.

$ docker volume create portainer_data

Étape 2 – Lancement du conteneur Portainer

Utilisez la commande suivante pour déployer Portainer CE sur le port 9000.

$ docker run -d -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest

✅ Portainer est maintenant accessible sur http://[IP_DU_SERVEUR]:9000

⚠️ Note : Si le port 9000 est déjà utilisé, vous pouvez le modifier dans la commande (ex: -p 9001:9000).

4 Accès à Portainer depuis le réseau local

Étape 1 – Récupérer l'adresse IP du serveur

Identifiez l'adresse IP de votre serveur Debian sur le réseau local.

$ ip a | grep inet
# ou
$ hostname -I

✅ Exemple : 192.168.1.100

Étape 2 – Connexion depuis un navigateur

Depuis un autre ordinateur sur le même réseau local, ouvrez un navigateur et accédez à :

http://192.168.1.100:9000

Remplacez 192.168.1.100 par l'IP de votre serveur.

Étape 3 – Configuration initiale de Portainer

À la première connexion, Portainer vous demandera de :

Créer un compte administrateur (nom d'utilisateur et mot de passe).
Connecter Portainer à votre environnement Docker (choisir "Local").

✅ Félicitations ! Portainer est opérationnel. Vous pouvez maintenant gérer vos conteneurs, images, volumes et réseaux depuis votre navigateur.

✅ Test de validation

🎉 Installation réussie si :

docker --version affiche la version installée.
docker run hello-world s'exécute sans erreur.
L'interface web de Portainer est accessible sur http://[IP]:9000.
Vous pouvez voir la liste des conteneurs dans Portainer.

📚 Ressources complémentaires

← Retour au portail

BTS SIO – Lycée NDLP Avranches – Tutoriel Docker v2.0