Retourner sur le site

Installer Docker et Docker Compose

Installez Docker Engine depuis le dépôt officiel et le plugin Docker Compose sur un VPS Linux HolyCloud (Ubuntu/Debian).

Installer Docker et Docker Compose

Docker permet d'isoler vos applications (API, bases, workers) sur un VPS Linux HolyCloud sans multiplier les machines. Ce guide suit le dépôt officiel Docker et installe le plugin Compose V2 (docker compose), recommandé en production.

Prérequis

  • VPS HolyCloud Ubuntu 22.04/24.04 ou Debian 12, 2 Go RAM minimum pour charges légères
  • Accès sudo, système à jour
  • Nom de domaine optionnel (pour exposer des services derrière Nginx + TLS)

Étape 1 : dépendances et dépôt officiel

sudo apt update
sudo apt install -y ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

Debian : remplacez ubuntu par debian dans l'URL GPG et le dépôt ci-dessous.

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update

Étape 2 : installation des paquets

sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Étape 3 : utilisateur et service

Ajoutez votre utilisateur au groupe docker (reconnexion SSH requise) :

sudo usermod -aG docker $USER
newgrp docker

Démarrage au boot :

sudo systemctl enable --now docker
sudo systemctl status docker --no-pager

Étape 4 : test rapide

docker run --rm hello-world
docker compose version

Exemple minimal compose.yaml :

mkdir -p ~/demo && cd ~/demo
cat > compose.yaml <<'EOF'
services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"
EOF
docker compose up -d
curl -sI http://127.0.0.1:8080 | head -1
docker compose down

Étape 5 : pare-feu HolyCloud

N'exposez que les ports nécessaires :

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
# évitez d'ouvrir 2375/tcp (API Docker non sécurisée)

Préférez publier les apps via Nginx reverse proxy sur 443 plutôt que des ports aléatoires.

Vérification

docker info | grep -E 'Server Version|Storage Driver'
docker ps
docker compose ls

Mises à jour :

sudo apt update && sudo apt upgrade -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

Besoin d'aide HolyCloud

  • Erreur Cannot connect to the Docker daemon : vérifiez sudo systemctl start docker et l'appartenance au groupe docker
  • Manque de RAM : réduisez les limites dans compose.yaml ou augmentez la offre VPS dans l'espace client
  • Support : sortie de docker info et journalctl -u docker -n 30