Utiliser le template Docker CE sur votre VPS KVM LWS

Procédure

Le template Docker CE installe Docker CE, Docker Compose et Buildx sur votre VPS KVM LWS, sans paquet à ajouter à la main. Ce guide vous apprend à réinstaller votre serveur avec ce template, puis à l'utiliser au quotidien avec Docker Compose. Vous verrez comment lancer un site, suivre ses journaux, conserver ses données, le mettre à jour et l'exposer sur Internet.

Installer Docker avec le template Docker CE

  1. Accéder à la gestion du serveur VPS KVM

    Connectez-vous à votre espace client LWS et ouvrez l'onglet Serveurs. Repérez votre VPS, puis cliquez sur Gérer pour ouvrir son interface.

    Utiliser le template Docker CE sur votre VPS KVM LWS
  2. Ouvrir l'outil de réinstallation

    Dans le menu latéral gauche, cliquez sur Réinstallation. Le catalogue des systèmes et des applications s'affiche.

    Utiliser le template Docker CE sur votre VPS KVM LWS
  3. Sélectionner le template Docker CE

    Dans la section des applications, sous la catégorie Docker, choisissez par exemple Docker CE ubuntu-24-04.

    Utiliser le template Docker CE sur votre VPS KVM LWS
  4. Sélectionner votre clé SSH et lancer la réinstallation

    Dans Clés SSH à installer (optionnel), cochez votre clé SSH. Cliquez ensuite sur Réinstaller le serveur en bas à droite.

    Utiliser le template Docker CE sur votre VPS KVM LWS
  5. Confirmer la réinstallation du système

    Dans la fenêtre d'avertissement, saisissez le nom exact de votre serveur, puis cliquez sur le bouton rouge Réinstallation.

    Utiliser le template Docker CE sur votre VPS KVM LWS
  6. Patienter pendant le déploiement

    Le système crée votre environnement avec Docker CE, Docker Compose et Buildx. L'opération prend généralement entre 3 et 5 minutes.

    Utiliser le template Docker CE sur votre VPS KVM LWS

Se connecter et vérifier l'installation

  1. Récupérer l'adresse IP et se connecter en SSH

    Quand le serveur repasse sur ON avec la mention Docker CE, notez son adresse IPv4 dans le bloc IPs du serveur. Ouvrez un terminal sur votre poste et connectez-vous en root, en remplaçant l'IP d'exemple par la vôtre.

    ⌨ Commande
    ssh root@203.0.113.10
    Utiliser le template Docker CE sur votre VPS KVM LWS
  2. Vérifier que Docker fonctionne

    Affichez les versions de Docker et de Docker Compose. Lancez ensuite le conteneur de test hello-world : il affiche un message puis s'arrête.

    ⌨ Sur le serveur
    docker --version
    docker compose version
    docker run --rm hello-world
    Résultat attendu
    Hello from Docker!
    This message shows that your installation appears to be working correctly.

Utiliser Docker au quotidien

  1. Créer un dossier de projet et un fichier compose.yaml

    Un fichier compose.yaml décrit vos conteneurs. Créez un dossier de projet avec un sous-dossier pour les pages du site et une page d'accueil. Créez ensuite le fichier compose.yaml : il lance Nginx, publie le port 8080 du serveur vers le port 80 du conteneur, monte le dossier local en lecture seule et redémarre le conteneur sauf arrêt manuel.

    ⌨ Sur le serveur
    mkdir -p /root/mon-site/html
    cd /root/mon-site
    echo '<h1>Bonjour depuis Docker</h1>' > html/index.html
    nano compose.yaml
    📄 /root/mon-site/compose.yaml
    services:
      web:
        image: nginx:stable
        ports:
          - "8080:80"
        volumes:
          - ./html:/usr/share/nginx/html:ro
        restart: unless-stopped
  2. Lancer le projet

    Depuis le dossier du projet, démarrez les services en arrière-plan. Docker télécharge l'image la première fois, puis crée le conteneur. Testez ensuite la réponse du site depuis le serveur.

    ⌨ Sur le serveur
    cd /root/mon-site
    docker compose up -d
    curl http://localhost:8080
    Résultat attendu
    <h1>Bonjour depuis Docker</h1>
  3. Voir les conteneurs et leurs journaux

    Listez les conteneurs du projet pour vérifier leur état. Suivez ensuite leurs journaux en direct pour repérer une erreur ou voir les requêtes reçues. Quittez le suivi avec Ctrl+C : les conteneurs continuent de tourner.

    ⌨ Sur le serveur
    docker compose ps
    docker compose logs -f
  4. Garder ses données avec les volumes

    Le contenu d'un conteneur disparaît quand celui-ci est supprimé. Pour conserver des données, placez-les dans un volume. Dans l'exemple, le dossier html est monté dans le conteneur : vos pages restent sur le serveur. Pour une base de données, utilisez plutôt un volume nommé, déclaré dans le fichier compose.yaml. Les commandes ci-dessous listent les volumes et affichent l'emplacement de l'un d'eux.

    ⌨ Sur le serveur
    docker volume ls
    docker volume inspect nom_du_volume
  5. Mettre à jour les images

    Pour passer à une version plus récente de l'image, téléchargez-la puis recréez le conteneur. Docker ne remplace que les services dont l'image a changé. Vos volumes sont conservés.

    ⌨ Sur le serveur
    cd /root/mon-site
    docker compose pull
    docker compose up -d
  6. Redémarrer automatiquement au démarrage du serveur

    Avec restart: unless-stopped dans le fichier compose.yaml, le conteneur redémarre après un redémarrage du serveur. Il reste arrêté si vous l'avez stoppé vous-même. Le service Docker démarre seul avec le système : vérifiez-le avec la commande ci-dessous.

    ⌨ Sur le serveur
    systemctl is-enabled docker
    Résultat attendu
    enabled
  7. Arrêter et nettoyer

    La première commande arrête et supprime les conteneurs du projet, mais garde vos fichiers et vos volumes. La seconde supprime les conteneurs arrêtés, les réseaux inutilisés et les images orphelines (sans étiquette). Docker vous demande une confirmation avant de l'exécuter.

    ⌨ Sur le serveur
    docker compose down
    docker system prune
  8. Exposer une application sur Internet

    La ligne ports du fichier compose.yaml publie un port du serveur. Avec 8080:80, le site répond sur le port 8080 de l'IP du serveur, par exemple http://203.0.113.10:8080. Si le pare-feu est actif sur votre VPS, ouvrez ce port dans le menu Pare-feu du panel KVM. Pour utiliser un nom de domaine comme exemple.com, faites-le pointer vers l'IP du serveur auprès de votre gestionnaire de DNS.

    ⌨ Commande
    curl http://203.0.113.10:8080
    Résultat attendu
    <h1>Bonjour depuis Docker</h1>

Lexique

compose.yaml
Fichier qui décrit les conteneurs d'un projet (image, ports, volumes, redémarrage) et que Docker Compose lit pour les lancer.
Volume
Espace de stockage conservé en dehors du conteneur, qui permet de garder des données même si le conteneur est supprimé ou recréé.
Image
Modèle figé contenant le code et les dépendances d'une application, à partir duquel Docker crée des conteneurs.
Conteneur
Instance en cours d'exécution d'une image, isolée du reste du serveur.

Questions fréquentes

Dois-je installer Docker Compose ou Docker Buildx séparément ?

Non. Le template Docker CE intègre le moteur Docker CE ainsi que les extensions Docker Compose et Docker Buildx. Ils sont utilisables dès la fin de la réinstallation.

Pourquoi ma clé SSH n'est-elle pas présente si je l'ajoute après coup ?

Les clés SSH sont injectées dans le compte root uniquement pendant l'installation du système. Si vous ajoutez une clé plus tard, ajoutez-la vous-même dans le fichier ~/.ssh/authorized_keys.

Comment exposer mon application Docker sur Internet ?

Publiez le port avec la section ports du fichier compose.yaml, par exemple 8080:80. Si le pare-feu est actif, ouvrez aussi ce port dans le menu Pare-feu du panel KVM.

Où sont stockées les données d'un volume ?

Pour un volume nommé, Docker les place sur le disque du serveur, sous /var/lib/docker/volumes. La commande docker volume inspect indique l'emplacement exact. Pour un dossier monté comme ./html, les données restent dans votre dossier de projet.

Comment voir les journaux d'un conteneur qui ne démarre pas ?

Depuis le dossier du projet, lancez docker compose ps -a pour voir l'état de chaque service, puis docker compose logs nom_du_service pour lire ses messages d'erreur. Une faute d'indentation dans le fichier compose.yaml est une cause fréquente.

Comment lancer un conteneur automatiquement au démarrage du serveur ?

Ajoutez restart: unless-stopped au service dans le fichier compose.yaml, puis relancez docker compose up -d. Le service Docker démarre avec le système et relance alors vos conteneurs.

Quelle est la différence entre une image Docker et un conteneur ?

Une image est un modèle figé qui contient le code et ses dépendances. Le conteneur est l'instance en cours d'exécution créée à partir de cette image.

La réinstallation de mon VPS KVM conserve-t-elle mes snapshots ?

Non. La réinstallation écrase le disque local et supprime définitivement les données ainsi que les snapshots existants.

aide.lws.fr/a/7930
Cet article vous a-t-il aidé ?

Oui

Non

Lu 1 fois

Merci ! N'hésitez pas à poser des questions sur nos documentations si vous souhaitez plus d'informations et nous aider à les améliorer.

Articles similaires

Une question sur cet article ?

Posez-la à l'équipe LWS et à la communauté. Réponse publiée après modération.

Poser une question à l'équipe LWS et à sa communauté

RGPD : Responsable : LWS-Ligne Web Services. Finalité : modération et publication publique de votre question, notification éventuelle d'une réponse. Base légale : consentement (art. 6.1.a RGPD). Conservation des emails : 90 jours après notification, 12 mois maximum sans réponse. Pour exercer vos droits, consultez la section RGPD de nos CGV.