Installer Docker sur un VPS Linux

Prérequis

Avant de commencer, vérifiez que vous avez :

• Un VPS Debian ou Ubuntu.
• Un accès SSH avec root ou sudo.
• Un système à jour.

Mettez le VPS à jour :

apt update && apt upgrade -y

Installez les paquets utiles :

apt install ca-certificates curl gnupg lsb-release -y

Installer Docker

Ajoutez la clé GPG officielle de Docker :

install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg
chmod a+r /etc/apt/keyrings/docker.gpg

Ajoutez le dépôt Docker pour Debian :

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

Mettez à jour la liste des paquets :

apt update

Installez Docker :

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

Vérifier l'installation

Activez Docker au démarrage :

systemctl enable docker
systemctl start docker

Vérifiez le service :

systemctl status docker

Vérifiez la version :

docker --version
docker compose version

Lancez un conteneur de test :

docker run hello-world

Utiliser Docker sans root

Si vous utilisez un compte non-root, ajoutez-le au groupe docker :

usermod -aG docker votre_utilisateur

Reconnectez-vous ensuite en SSH pour appliquer le changement.

Vérifiez :

docker ps

Lancer un premier service

Créez un dossier de test :

mkdir -p /opt/docker-test
cd /opt/docker-test

Créez un fichier docker-compose.yml :

services:
  nginx:
    image: nginx:alpine
    container_name: nginx-test
    ports:
      - "8080:80"
    restart: unless-stopped

Lancez le service :

docker compose up -d

Vérifiez les conteneurs :

docker ps

Testez depuis le VPS :

curl http://localhost:8080

Commandes utiles

Afficher les conteneurs actifs :

docker ps

Afficher tous les conteneurs :

docker ps -a

Voir les logs :

docker logs nginx-test

Arrêter un conteneur :

docker stop nginx-test

Supprimer un conteneur :

docker rm nginx-test

Nettoyer les ressources inutilisées :

docker system prune

Erreurs fréquentes

Cannot connect to the Docker daemon

Docker n'est probablement pas lancé :

systemctl restart docker

Permission denied while trying to connect

Votre utilisateur n'est pas dans le groupe docker, ou vous devez vous reconnecter en SSH.

Port already allocated

Le port est déjà utilisé. Changez le port exposé, par exemple 8081:80.

Conclusion

Docker et Docker Compose sont installés sur votre VPS. Vous pouvez maintenant déployer des applications isolées, des bases de données, des panels ou des services web avec des fichiers docker-compose.yml.