Sur Windows 11, installer WSL2 et Docker transforme l’ordinateur en poste de développement Linux complet. Cette configuration allie la puissance des conteneurs à la compatibilité Windows, pour un workflow fluide et maîtrisé.
Le guide qui suit propose un parcours pratique pour un setup propre et performant, avec des conseils pour VS Code et la sécurité. Gardez en tête les points clés résumés ensuite.
A retenir :
- Installation WSL2 en un seul appel système
- Docker Desktop avec backend WSL2 recommandé
- Placer les projets dans le système de fichiers WSL
- Possibilité d’exécuter Docker sans Docker Desktop
Configurer WSL2 et Docker Desktop sous Windows 11
Après avoir retenu les points clés, il convient d’installer WSL2 puis Docker Desktop afin d’obtenir la meilleure compatibilité Windows. Selon Microsoft Learn, WSL2 fournit un noyau Linux réel et améliore les performances des outils Linux sur Windows.
L’activation se fait via PowerShell en administrateur et la commande wsl –install pour les machines à jour, puis wsl –set-default-version 2 pour garantir l’usage du noyau correct. Selon Docker Docs, Docker Desktop détecte et sélectionne WSL2 comme moteur par défaut sur les systèmes compatibles.
Une vérification simple consiste à ouvrir votre distribution WSL et lancer docker –version et docker run hello-world pour valider la chaîne CLI et démon. Cette étape prépare l’intégration avec Visual Studio Code et le flux de développement conteneurisé.
Pour les équipes sensibles à l’isolation, Hyper-V reste une option viable, mais la plupart des développeurs profitent mieux de WSL2 pour sa simplicité et sa performance. La suite explique comment tirer parti de ces choix en pratique.
Conseils d’installation WSL :
- Activer la virtualisation dans le BIOS
- Utiliser wsl –install pour simplifier
- Choisir une distribution LTS comme Ubuntu
- Définir WSL2 par défaut pour cohérence
Mode
Installation
Intégration VS Code
Usage recommandé
Docker Desktop
Installeur Windows
Intégration WSL automatique
Développement général
Docker Engine dans WSL2
apt et dépôt officiel
Extension Dev Containers
Léger et sans Desktop
wslc (WSL container CLI)
Inclus avec WSL
Terminal intégré
Tests rapides et scripts
Hyper-V isolé
Rôle Windows
Compatible mais moins pratique
Environnements très sécurisés
« J’ai migré mes projets dans /home pour gagner des minutes sur chaque build local »
Alex N.
Développement conteneurisé avec Visual Studio Code et WSL2
Enchaînement logique après l’installation : ouvrir VS Code depuis la distribution WSL pour coder directement sur le système de fichiers Linux. Selon la documentation de VS Code, l’extension WSL permet d’exécuter l’éditeur sur le serveur d’extension WSL.
L’extension Dev Containers offre un cadre pour standardiser l’environnement de l’équipe via un Dockerfile et un fichier devcontainer.json. Selon Docker Docs, cela facilite les builds reproductibles et la configuration partagée entre développeurs.
Ce flux réduit les problèmes de dépendances et permet le débogage dans le conteneur, avec accès aux ports exposés sur localhost depuis Windows. Ce point prépare ensuite la mise en place de Docker sans Desktop si nécessaire.
Extensions VS Code recommandées :
- Remote – WSL pour ouvrir des dossiers Linux
- Dev Containers pour environnements reproductibles
- Docker pour gérer images et conteneurs depuis VS Code
- Python ou autres langages selon la pile
Extensions essentielles pour le développement conteneurisé
Ce sous-ensemble d’extensions permet de rester productif sans sortir de l’éditeur, et il réduit les erreurs de configuration entre coéquipiers. L’expérience est plus cohérente quand tout le monde utilise les mêmes extensions et versions.
Extension
Usage principal
Avantage clé
Remote – WSL
Ouverture de dossier WSL
Accès direct aux fichiers Linux
Dev Containers
Standardisation d’image
Reproductibilité d’équipe
Docker
Gestion d’images
Visualisation des conteneurs
Debugger
Exécution et débogage
Breakpoints dans conteneurs
Flux de travail devcontainer et exemples pratiques
Pour cloner un projet dans WSL, lancez code . depuis le répertoire du projet pour ouvrir l’éditeur sur le serveur WSL local. Ensuite, utilisez la palette de commandes pour rouvrir le dossier dans un conteneur.
Un cas concret : une application Django contenue via un Containerfile, construction locale et test sur http://localhost:8000. Ce scénario est courant pour les équipes web et illustre l’efficacité du duo WSL2 et Docker.
« Ouvrir VS Code depuis WSL a réduit mes erreurs de permissions et accéléré les tests »
Marie N.
Docker dans WSL2 sans Docker Desktop pour un setup propre
Après avoir maîtrisé l’intégration VS Code, certains choisissent d’exécuter Docker Engine directement dans WSL2 pour limiter les dépendances externes. Selon Docker Docs, cette méthode supprime Docker Desktop tout en conservant l’accès aux conteneurs Linux.
L’installation passe par l’ajout du dépôt Docker officiel sous la distribution, puis l’installation de docker-ce, docker-ce-cli et containerd.io via apt. Ensuite, l’utilisateur est ajouté au groupe docker pour éviter sudo répété.
La gestion du démon s’effectue par sudo dockerd ou par scripts de démarrage dédiés, et il est possible de configurer DOCKER_HOST pour piloter le démon depuis PowerShell. Cette configuration impose des mesures de sécurité adaptées.
Paramètres Docker sans Desktop :
- Remplacer ~ par chemin WSL complet
- Ajouter extra_hosts pour host.docker.internal
- Éviter TLS non chiffré en production
- Nettoyer images et conteneurs inutiles
Installer Docker Engine dans WSL2 pas à pas
Commencez par mettre à jour les paquets, puis ajoutez la clé GPG et le dépôt Docker officiel pour votre distribution Ubuntu. Ces étapes garantissent une installation depuis les sources maintenues par Docker.
Après l’installation, testez avec docker run –rm hello-world puis configurez DOCKER_HOST si vous souhaitez piloter le démon depuis l’hôte Windows. Ce mode convient exclusivement au développement local.
« Passer sans Docker Desktop m’a simplifié la vie sur une VM distante, économisant des ressources »
Paul N.
Sécurité, DOCKER_HOST et bonnes pratiques
L’ouverture du démon sur TCP sans TLS doit rester confinée aux environnements locaux et testés, et il faut l’éviter avec des données sensibles. Privilégiez des tunnels sécurisés ou l’utilisation d’un socket Unix quand c’est possible.
Nettoyez régulièrement l’espace disque avec des commandes de prune et surveillez l’usage des images. Une bonne hygiène évite que Docker n’accapare l’espace disponible sur la distribution WSL.
« L’approche WSL2 + Docker m’a permis de reproduire la production sans quitter Windows »
Tech N.
La prochaine étape consiste à consulter la documentation officielle et les guides pratiques pour approfondir les réglages et la résolution des erreurs fréquentes. Les sources ci-dessous orientent vers des références fiables et maintenues.
Source : Microsoft, « Windows Subsystem for Linux », Microsoft Learn, 2024 ; Docker, « Docker Desktop documentation », Docker Docs, 2025 ; Visual Studio Code, « Developing in WSL », VS Code Docs, 2024.