Si WSL est absent
Ouvrez PowerShell en administrateur, exécutez la commande ci-dessous, puis redémarrez le PC lorsque Windows le demande.
wsl --installAvant de commencer
Vérifiez le PC avant toute installation
Docker recommande WSL 2 pour la majorité des utilisateurs Windows. La virtualisation matérielle doit être activée et le PC doit disposer d’une version Windows encore prise en charge.
Machine virtuelle : si Windows fonctionne dans VMware, Hyper-V ou un autre hyperviseur, la virtualisation imbriquée doit être disponible. Ce scénario n’est pas garanti sur toutes les éditions.
Étape 1
Installer ou mettre à jour WSL 2
Commencez par demander l’état actuel. N’exécutez l’installation qu’en l’absence de WSL. L’activation initiale peut demander les droits administrateur et un redémarrage complet du PC.
Où saisir les commandes ? ouvrez le menu Démarrer, recherchez PowerShell, puis choisissez « Exécuter en tant qu’administrateur » uniquement pour
wsl --install. Copiez uniquement la commande affichée dans le cadre, sans copier PS C:\> ni le texte du résultat.Contrôler WSL
wsl --version
wsl --status
wsl -l -vSi WSL est déjà présent
Mettez WSL à jour, puis contrôlez que la version indiquée est au minimum 2.1.5. La version la plus récente reste préférable.
wsl --updateContrôler la distribution
La colonne VERSION doit indiquer 2 pour la distribution utilisée.
wsl -l -vCe qui apparaît réellement au premier lancement d’Ubuntu
- Choisissez un nom d’utilisateur Linux. Il peut être différent de votre compte Windows.
- Saisissez ensuite un mot de passe Linux. Aucun caractère ni astérisque ne s’affiche pendant la frappe : c’est normal.
- Ubuntu peut proposer l’envoi de statistiques anonymes à Canonical. Répondez
ypour accepter ounpour refuser ; ce choix est facultatif et n’empêche pas Docker de fonctionner. - Lorsque l’invite se termine par
$, Ubuntu est prêt. Ne publiez jamais une capture contenant votre nom d’utilisateur ou le nom de votre PC sans les masquer.
Installer ou mettre à jour
wsl --install
wsl --updateWSL répond
wsl --version affiche un numéro de version sans message d’échec.Distribution en version 2
wsl -l -v affiche le chiffre 2 dans la colonne VERSION.Étape 2
Installer Docker Desktop depuis la source officielle
Pour un PC personnel classique, le mode par utilisateur est recommandé par Docker : il utilise WSL 2, réduit la surface privilégiée et ne demande pas de droits administrateur pour les mises à jour courantes.
| Choix | Par utilisateur — recommandé | Tous les utilisateurs |
|---|---|---|
| Emplacement | %LOCALAPPDATA%\Programs\DockerDesktop | C:\Program Files\Docker\Docker |
| Installation | Sans droits administrateur, hors activation initiale de WSL | Droits administrateur requis |
| Moteur Linux | WSL 2 | WSL 2 ou Hyper-V |
| Usage conseillé | Poste personnel et développement courant | Cas administrés ou conteneurs Windows |
Évitez les sites tiers : utilisez uniquement le téléchargement officiel Docker et vérifiez les conditions de licence Docker Desktop pour un usage professionnel.
Étape 3
Effectuer le premier démarrage
Lancer Docker Desktop
Acceptez les conditions applicables uniquement après les avoir lues, puis attendez la fin de l’initialisation.
Installer la mise à jour proposée
Si Docker Desktop signale une nouvelle version au premier démarrage, installez-la puis laissez l’application redémarrer. Une mise à jour peut être proposée même après avoir utilisé un installateur récent.
Vérifier le moteur WSL 2
Dans Settings → General, conservez « Use the WSL 2 based engine » lorsque ce choix est disponible.
Attendre l’état prêt
Ne lancez pas de commande tant que Docker Desktop n’indique pas « Engine running » en bas à gauche. La connexion à un compte Docker reste facultative pour les premiers exercices locaux.
Conflit à éviter : Docker déconseille de conserver une installation séparée de Docker Engine ou de la CLI directement dans la distribution WSL utilisée avec Docker Desktop.
Test réel
Valider le moteur avec hello-world
Ouvrez un nouveau terminal PowerShell standard. Les deux premières commandes doivent afficher le client et le serveur Docker. La dernière télécharge une petite image officielle puis supprime automatiquement le conteneur de test.
Diagnostic Docker
docker version
docker info
docker run --rm hello-worldClient + Server visiblesLa CLI communique correctement avec le moteur.
Hello from Docker!Le téléchargement et l’exécution d’un conteneur fonctionnent.
Vous pouvez passer au module suivant lorsque : Docker Desktop affiche « Engine running », la commande
docker version montre les sections Client et Server, et le terminal affiche « Hello from Docker! ». Si l’un de ces trois résultats manque, utilisez le tableau de dépannage ci-dessous.Si le test échoue
Les quatre vérifications utiles
| Symptôme | Vérification | Action prudente |
|---|---|---|
| Virtualisation absente | Gestionnaire des tâches → Processeur | L’activer dans l’UEFI/BIOS selon la documentation du fabricant. |
| WSL trop ancien | wsl --version | Exécuter wsl --update, puis redémarrer WSL ou le PC. |
| Cannot connect to daemon | État de Docker Desktop | Démarrer Docker Desktop et attendre que le moteur soit prêt. |
| Échec dans une VM | Virtualisation imbriquée | Vérifier sa prise en charge par l’hyperviseur et l’édition utilisée. |
Ne réinitialisez pas Docker immédiatement : une remise à zéro peut supprimer les conteneurs, images et volumes locaux. Commencez toujours par lire le message d’erreur.
Validation
Vérifiez votre installation
Fin du parcours Windows
Docker est prêt sur Windows.
N’installez pas Docker Engine pour Ubuntu en plus : passez directement au premier conteneur, commun aux deux systèmes.