Installer Docker Engine et Docker Compose
Installez Docker Engine et Docker Compose depuis le dépôt officiel sur Debian ou Ubuntu : utilisateurs, journaux, ports, mises à jour, sauvegardes et bonnes pratiques.
Sur cette page
Ce guide vous explique comment installer Docker Engine et le plugin Docker Compose depuis le dépôt officiel de Docker, puis comment préparer votre serveur pour un usage en production : droits des utilisateurs, rotation des journaux, exposition des ports, mises à jour et sauvegardes.
Commander un serveur
Pour héberger vos conteneurs, HostMyServers propose plusieurs offres :
Prérequis
- Un serveur 64 bits sous Debian 12/13 ou Ubuntu 22.04/24.04
- Un accès SSH avec
rootou un utilisateursudo
Ports : Docker n'a besoin d'aucun port entrant. N'ouvrez que les ports des applications que vous publiez, et n'exposez jamais l'API Docker (2375 ou 2376) sur Internet : y accéder revient à contrôler le serveur.
Étape 1 : retirer les paquets en conflit
Les paquets Docker fournis par la distribution peuvent entrer en conflit avec les paquets officiels :
sudo apt update
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc 2>/dev/null | cut -f1)Vos images et volumes éventuels dans /var/lib/docker ne sont pas supprimés par cette commande.
Étape 2 : ajouter le dépôt officiel
Ces commandes conviennent à Debian comme à Ubuntu, car elles lisent le système dans /etc/os-release :
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
. /etc/os-release
sudo curl -fsSL "https://download.docker.com/linux/$ID/gpg" -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/$ID
Suites: ${UBUNTU_CODENAME:-$VERSION_CODENAME}
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt updateÉtape 3 : installer Docker
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker containerdÉtape 4 : vérifier l'installation
sudo systemctl status docker
docker --version
docker compose version
sudo docker run --rm hello-worldLe message Hello from Docker! confirme que le moteur peut télécharger une image et lancer un conteneur.
Étape 5 : autoriser un utilisateur
Pour lancer Docker sans sudo, ajoutez votre utilisateur au groupe docker, puis déconnectez-vous et reconnectez-vous :
sudo usermod -aG docker $USERVérifiez ensuite :
docker run --rm hello-worldÉtape 6 : configurer les journaux et le démon
Par défaut, le pilote json-file ne limite pas la taille des journaux, qui peuvent finir par remplir le disque. Créez /etc/docker/daemon.json :
sudo nano /etc/docker/daemon.json{
"log-driver": "local",
"log-opts": {
"max-size": "10m",
"max-file": "3"
},
"live-restore": true
}| Option | Effet |
|---|---|
log-driver: local |
Format de journal compact, avec rotation |
max-size, max-file |
Jusqu'à 3 fichiers de 10 Mo par conteneur |
live-restore |
Les conteneurs continuent de tourner si le démon s'arrête |
Validez le fichier, puis redémarrez Docker. Ce redémarrage interrompt les conteneurs en cours : faites-le de préférence avant de déployer vos applications.
sudo dockerd --validate --config-file=/etc/docker/daemon.json
sudo systemctl restart docker
docker info --format '{{.LoggingDriver}} {{.LiveRestoreEnabled}}'Le pilote de journaux ne s'applique qu'aux nouveaux conteneurs. Recréez les conteneurs existants pour en bénéficier, par exemple avec docker compose up -d --force-recreate.
Étape 7 : maîtriser les ports publiés
Si un reverse proxy tourne sur le serveur, publiez vos applications uniquement en local :
ports:
- "127.0.0.1:8080:80"Vous pouvez aussi faire de l'adresse locale le comportement par défaut, en ajoutant ces clés dans /etc/docker/daemon.json :
{
"ip": "127.0.0.1",
"default-network-opts": {
"bridge": {
"com.docker.network.bridge.host_binding_ipv4": "127.0.0.1"
}
}
}Fusionnez-les avec le fichier de l'étape 6, validez-le, puis redémarrez Docker. Un port destiné au public devra alors être indiqué explicitement, par exemple "0.0.0.0:443:443".
Étape 8 : lancer un premier projet Compose
Créez un dossier pour le projet :
sudo mkdir -p /opt/myapp
sudo chown "$USER": /opt/myapp
cd /opt/myapp
nano compose.yamlservices:
web:
image: nginx:1.30-alpine
restart: unless-stopped
ports:
- "127.0.0.1:8080:80"
volumes:
- web-data:/usr/share/nginx/html
healthcheck:
test: ["CMD", "wget", "-qO-", "http://127.0.0.1/"]
interval: 30s
timeout: 5s
retries: 3
volumes:
web-data:Démarrez puis vérifiez :
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=20 web
curl -I http://127.0.0.1:8080Pour publier cette application en HTTPS, placez un reverse proxy devant elle. Vous pouvez partir du guide Installer Nginx et PHP-FPM et du guide Let's Encrypt.
Commandes utiles
| Commande | Description |
|---|---|
docker ps -a |
Lister les conteneurs |
docker compose logs -f |
Suivre les journaux du projet |
docker compose restart |
Redémarrer les services |
docker compose down |
Arrêter et supprimer les conteneurs, en conservant les volumes |
docker system df |
Afficher l'espace utilisé |
Mises à jour
Docker Engine
sudo apt update
sudo apt install --only-upgrade docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker --versionlive-restore ne couvre que les mises à jour correctives. Pour une version majeure, prévoyez une interruption de vos conteneurs et consultez les notes de version de Docker.
Images des applications
Modifiez le tag dans compose.yaml si vous le fixez, puis :
cd /opt/myapp
docker compose pull
docker compose up -d
docker image pruneSauvegarde
Sauvegardez au minimum vos fichiers Compose, vos fichiers .env et vos volumes. Les volumes se trouvent dans /var/lib/docker/volumes, mais il vaut mieux les archiver via un conteneur temporaire. Le nom réel du volume s'obtient avec docker volume ls :
cd /opt/myapp
mkdir -p backups
docker compose stop web
docker run --rm -v myapp_web-data:/data:ro -v "$PWD/backups":/backup alpine:3 tar czf /backup/web-data.tar.gz -C /data .
docker compose start webPour restaurer l'archive dans un volume :
docker compose stop web
docker run --rm -v myapp_web-data:/data -v "$PWD/backups":/backup:ro alpine:3 tar xzf /backup/web-data.tar.gz -C /data
docker compose start webPour une base de données, préférez un export avec l'outil du moteur (mariadb-dump, pg_dump, etc.). Copiez ensuite vos sauvegardes hors du serveur.
Bonnes pratiques en production
- Fixez une version d'image précise plutôt que
latest - Définissez
restart: unless-stoppedet unhealthcheckpour vos services - Publiez le moins de ports possible, et en local derrière un reverse proxy quand c'est possible
- Gardez vos secrets dans un fichier
.envprotégé (chmod 600 .env), hors de Git - N'utilisez pas
privileged: trueet ne montez pas/var/run/docker.socksans nécessité - Surveillez l'espace disque avec
docker system df - Testez régulièrement la restauration de vos sauvegardes
En cas de problème
permission denied sur /var/run/docker.sock
Votre utilisateur n'est pas encore pris en compte dans le groupe docker. Vérifiez avec id, puis reconnectez-vous en SSH.
Conflicting values set for option Signed-By
Une ancienne configuration du dépôt Docker subsiste, souvent /etc/apt/sources.list.d/docker.list. Après avoir vérifié son contenu, supprimez-la :
sudo rm /etc/apt/sources.list.d/docker.list
sudo apt updateCannot connect to the Docker daemon
sudo systemctl status docker
sudo journalctl -u docker -n 50 --no-pager
sudo dockerd --validate --config-file=/etc/docker/daemon.jsonUne erreur de syntaxe dans daemon.json empêche le démarrage du service.
port is already allocated ou address already in use
Un autre conteneur ou service utilise ce port. Identifiez-le avec sudo ss -ltnp | grep ':8080 ' et docker ps, puis changez le port côté serveur.
no space left on device
df -h
docker system df
docker image prune
docker builder pruneN'utilisez docker volume prune qu'après avoir vérifié que les volumes concernés ne contiennent plus de données utiles.
toomanyrequests lors d'un téléchargement
La limite de téléchargement de Docker Hub est atteinte. Patientez, ou connectez-vous à votre compte avec docker login.
docker-compose: command not found
Le plugin actuel s'utilise avec un espace : docker compose.
Un port reste accessible malgré UFW
C'est le comportement normal des ports publiés par Docker. Publiez le port sur 127.0.0.1 ou appliquez les restrictions du guide Configurer UFW.