🛠️ Tutoriel Pas-à-Pas : Installer Docker et Docker Compose sur Raspberry Pi OS (Raspbian)

Le Raspberry Pi sous Raspberry Pi OS (anciennement Raspbian) est le serveur hôte idéal pour démarrer son premier homelab Docker à moindre coût. Grâce aux scripts officiels, l'installation ne prend que 5 minutes.

  [Mise à jour du système] ──► [Script d'installation Docker] ──► [Gestion des permissions] ──► [Validation]

Étape 1 : Mettre à jour le système

Connectez-vous en SSH à votre Raspberry Pi et mettez à jour la liste des paquets ainsi que le système d'exploitation :


sudo apt update && sudo apt upgrade -y

Étape 2 : Lancer le script d'installation officiel de Docker

Plutôt que d'installer manuellement les dépôts, l'équipe Docker fournit un script automatisé parfaitement calibré pour les architectures ARM (32-bit et 64-bit) du Raspberry Pi :

# Téléchargement du script d'installation
curl -fsSL https://get.docker.com -o get-docker.sh

# Exécution du script
sudo sh get-docker.sh

Étape 3 : Ajouter votre utilisateur au groupe Docker

Par défaut, l'exécution des commandes Docker nécessite les privilèges administrateur (sudo). Pour pouvoir lancer vos conteneurs avec votre utilisateur habituel (ex: pi), ajoutez-le au groupe docker :

sudo usermod -aG docker $USER

> Important : Déconnectez-vous puis reconnectez-vous en SSH (ou tapez newgrp docker) pour que le changement de groupe soit pris en compte.

Étape 4 : Activer le démarrage automatique au boot

Pour que vos conteneurs redémarrent automatiquement après une coupure de courant ou un redémarrage du Raspberry Pi, activez le service Docker au démarrage système :

sudo systemctl enable docker
sudo systemctl start docker

Étape 5 : Vérifier l'installation de Docker & Docker Compose

Vérifiez que le moteur Docker ainsi que le plugin Docker Compose (désormais intégré nativement) sont bien fonctionnels :

# Vérifier la version de Docker
docker --version

# Vérifier la version de Docker Compose
docker compose version

# Tester le lancement d'un conteneur de démonstration
docker run hello-world

Si le message "Hello from Docker!" s'affiche à l'écran, votre Raspberry Pi est désormais configuré et prêt à héberger votre suite de services autonomes !

Voici une cheatsheet des commandes de base de Docker

📦 1. Gestion des Conteneurs
# Lister les conteneurs actifs
docker ps

# Lister tous les conteneurs (actifs et arrêtés)
docker ps -a

# Lancer un conteneur en arrière-plan
docker run -d --name MON_CONTENEUR -p PORT_HOTE:PORT_CONTENEUR NOM_IMAGE

# Démarrer, arrêter ou redémarrer un conteneur
docker start CONTENEUR_ID
docker stop CONTENEUR_ID
docker restart CONTENEUR_ID

# Supprimer un conteneur arrêté
docker rm CONTENEUR_ID

# Forcer la suppression d'un conteneur actif
docker rm -f CONTENEUR_ID

# Suivre les journaux (logs) en temps réel
docker logs -f CONTENEUR_ID

# Ouvrir un terminal interactif dans un conteneur
docker exec -it CONTENEUR_ID /bin/bash

🖼️ 2. Gestion des Images

# Lister les images locales
docker images

# Télécharger une image depuis Docker Hub
docker pull NOM_IMAGE:TAG

# Supprimer une image locale
docker rmi IMAGE_ID

# Construire une image depuis un Dockerfile local
docker build -t NOM_IMAGE:TAG .

🎼 3. Docker Compose

# Lancer tous les services du fichier docker-compose.yml en arrière-plan
docker compose up -d

# Arrêter et supprimer tous les conteneurs et réseaux de la pile
docker compose down

# Afficher l'état des services de la pile
docker compose ps

# Suivre les logs de tous les services en direct
docker compose logs -f

# Redémarrer un service spécifique
docker compose restart NOM_SERVICE

# Télécharger les nouvelles images et relancer la pile
docker compose pull && docker compose up -d

💾 4. Volumes et Réseaux

# Lister les volumes de stockage permanents
docker volume ls

# Trouver le chemin d'accès physique d'un volume sur l'hôte
docker volume inspect NOM_VOLUME

# Lister les réseaux virtuels Docker
docker network ls

# Créer un réseau personnalisé
docker network create NOM_RESEAU

🧹 5. Nettoyage et Maintenance

# Vérifier l'espace disque consommé par Docker
docker system df

# Supprimer tous les conteneurs arrêtés
docker container prune -f

# Supprimer les images orphelines/inutilisées
docker image prune -a -f

# Purge globale (conteneurs, réseaux et images inutilisés)
docker system prune -a --volumes -f