FR

Applications

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.

6 min de lecture, mis à jour le 18 novembre 2026

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 root ou un utilisateur sudo

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 :

Terminal
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 :

Terminal
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

Terminal
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

Terminal
sudo systemctl status docker
docker --version
docker compose version
sudo docker run --rm hello-world

Le 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 :

Terminal
sudo usermod -aG docker $USER

Vérifiez ensuite :

Terminal
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 :

Terminal
sudo nano /etc/docker/daemon.json
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.

Terminal
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 :

YAML
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 :

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 :

Terminal
sudo mkdir -p /opt/myapp
sudo chown "$USER": /opt/myapp
cd /opt/myapp
nano compose.yaml
YAML
services:
  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 :

Terminal
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=20 web
curl -I http://127.0.0.1:8080

Pour 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

Terminal
sudo apt update
sudo apt install --only-upgrade docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker --version

live-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 :

Terminal
cd /opt/myapp
docker compose pull
docker compose up -d
docker image prune

Sauvegarde

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 :

Terminal
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 web

Pour restaurer l'archive dans un volume :

Terminal
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 web

Pour 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-stopped et un healthcheck pour 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 .env protégé (chmod 600 .env), hors de Git
  • N'utilisez pas privileged: true et ne montez pas /var/run/docker.sock sans 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 :

Terminal
sudo rm /etc/apt/sources.list.d/docker.list
sudo apt update

Cannot connect to the Docker daemon

Terminal
sudo systemctl status docker
sudo journalctl -u docker -n 50 --no-pager
sudo dockerd --validate --config-file=/etc/docker/daemon.json

Une 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

Terminal
df -h
docker system df
docker image prune
docker builder prune

N'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.

Références