Installer Docker Desktop sur Windows
Conditions d'utilisation Docker Desktop
L'utilisation commerciale de Docker Desktop dans les grandes entreprises (plus de 250 employés OU plus de 10 millions USD de revenus annuels) nécessite un abonnement payant.
Cette page fournit des liens de téléchargement, les exigences système et des instructions d'installation étape par étape pour Docker Desktop sur Windows.
Pour les sommes de contrôle, voir Notes de version
Exigences système
TipDois-je utiliser Hyper-V ou WSL ?
La fonctionnalité de Docker Desktop reste cohérente sur WSL et Hyper-V, sans préférence pour l'une ou l'autre architecture. Hyper-V et WSL ont leurs propres avantages et inconvénients, selon votre configuration spécifique et votre cas d'usage prévu.
- WSL version 2.1.5 ou ultérieure.
- Windows 11 64-bit : version Home ou Pro 22H2 ou supérieure, ou version Enterprise ou Education 22H2 ou supérieure.
- Windows 10 64-bit : Minimum requis est Home ou Pro 22H2 (build 19045) ou supérieur, ou Enterprise ou Education 22H2 (build 19045) ou supérieur.
- Activez la fonctionnalité WSL 2 sur Windows. Pour des instructions détaillées, référez-vous à la documentation Microsoft.
- Les prérequis matériels suivants sont requis pour exécuter avec succès
WSL 2 sur Windows 10 ou Windows 11 :
- Processeur 64-bit avec Second Level Address Translation (SLAT)
- 4 Go de RAM système
- Activez la virtualisation matérielle dans BIOS/UEFI. Pour plus d'informations, voir Virtualisation.
Pour plus d'informations sur la configuration de WSL 2 avec Docker Desktop, voir WSL.
NoteDocker ne prend en charge Docker Desktop sur Windows que pour les versions de Windows qui sont encore dans la chronologie de service de Microsoft. Docker Desktop n'est pas pris en charge sur les versions serveur de Windows, telles que Windows Server 2019 ou Windows Server 2022. Pour plus d'informations sur l'exécution de conteneurs sur Windows Server, voir la documentation officielle de Microsoft.
ImportantPour exécuter des conteneurs Windows, vous avez besoin de Windows 10 ou Windows 11 Professional ou Enterprise edition. Les éditions Windows Home ou Education vous permettent seulement d'exécuter des conteneurs Linux.
-
Windows 11 64-bit : Enterprise, Pro, ou Education version 22H2 ou supérieure.
-
Windows 10 64-bit : Enterprise, Pro, ou Education version 22H2 (build 19045) ou supérieure.
-
Activez les fonctionnalités Windows Hyper-V et Containers.
-
Les prérequis matériels suivants sont requis pour exécuter avec succès Client Hyper-V sur Windows 10 :
- Processeur 64 bit avec Second Level Address Translation (SLAT)
- 4 Go de RAM système
- Activez le support de virtualisation matérielle au niveau BIOS/UEFI dans les paramètres BIOS/UEFI. Pour plus d'informations, voir Virtualisation.
NoteDocker ne prend en charge Docker Desktop sur Windows que pour les versions de Windows qui sont encore dans la chronologie de service de Microsoft. Docker Desktop n'est pas pris en charge sur les versions serveur de Windows, telles que Windows Server 2019 ou Windows Server 2022. Pour plus d'informations sur l'exécution de conteneurs sur Windows Server, voir la documentation officielle de Microsoft.
ImportantPour exécuter des conteneurs Windows, vous avez besoin de Windows 10 ou Windows 11 Professional ou Enterprise edition. Les éditions Windows Home ou Education vous permettent seulement d'exécuter des conteneurs Linux.
- WSL version 2.1.5 ou ultérieure.
- Windows 11 64-bit : version Home ou Pro 22H2 ou supérieure, ou version Enterprise ou Education 22H2 ou supérieure.
- Windows 10 64-bit : Minimum requis est Home ou Pro 22H2 (build 19045) ou supérieur, ou Enterprise ou Education 22H2 (build 19045) ou supérieur.
- Activez la fonctionnalité WSL 2 sur Windows. Pour des instructions détaillées, référez-vous à la documentation Microsoft.
- Les prérequis matériels suivants sont requis pour exécuter avec succès
WSL 2 sur Windows 10 ou Windows 11 :
- Processeur 64-bit avec Second Level Address Translation (SLAT)
- 4 Go de RAM système
- Activez la virtualisation matérielle dans BIOS/UEFI. Pour plus d'informations, voir Virtualisation.
ImportantLes conteneurs Windows ne sont pas pris en charge.
Les conteneurs et images créés avec Docker Desktop sont partagés entre tous les comptes utilisateur sur les machines où il est installé. C'est parce que tous les comptes Windows utilisent la même VM pour construire et exécuter des conteneurs. Notez qu'il n'est pas possible de partager des conteneurs et des images entre les comptes utilisateur lors de l'utilisation du backend Docker Desktop WSL 2.
L'exécution de Docker Desktop dans une VM VMware ESXi ou Azure est prise en charge pour les clients Docker Business. Cela nécessite d'activer d'abord la virtualisation imbriquée sur l'hyperviseur. Pour plus d'informations, voir Exécuter Docker Desktop dans un environnement VM ou VDI.
Installer Docker Desktop sur Windows
TipVoir les FAQ sur comment installer et exécuter Docker Desktop sans avoir besoin de privilèges administrateur.
Installation interactive
-
Téléchargez l'installateur en utilisant le bouton de téléchargement en haut de la page, ou depuis les notes de version.
-
Double-cliquez sur
Docker Desktop Installer.exe
pour exécuter l'installateur. Par défaut, Docker Desktop est installé dansC:\Program Files\Docker\Docker
. -
Lorsque demandé, assurez-vous que l'option Utiliser WSL 2 au lieu d'Hyper-V sur la page de Configuration est sélectionnée ou non selon votre choix de backend.
Sur les systèmes qui ne prennent en charge qu'un seul backend, Docker Desktop sélectionne automatiquement l'option disponible.
-
Suivez les instructions de l'assistant d'installation pour autoriser l'installateur et procéder à l'installation.
-
Lorsque l'installation est réussie, sélectionnez Fermer pour terminer le processus d'installation.
Si votre compte administrateur est différent de votre compte utilisateur, vous devez ajouter l'utilisateur au groupe docker-users :
- Exécutez Gestion de l'ordinateur en tant qu'administrateur.
- Naviguez vers Utilisateurs et groupes locaux > Groupes > docker-users.
- Clic droit pour ajouter l'utilisateur au groupe.
- Déconnectez-vous et reconnectez-vous pour que les changements prennent effet.
Installation depuis la ligne de commande
Après avoir téléchargé Docker Desktop Installer.exe
, exécutez la commande suivante dans un terminal pour installer Docker Desktop :
$ "Docker Desktop Installer.exe" install
Si vous utilisez PowerShell, vous devriez l'exécuter comme :
Start-Process 'Docker Desktop Installer.exe' -Wait install
Si vous utilisez l'Invite de commandes Windows :
start /w "" "Docker Desktop Installer.exe" install
Par défaut, Docker Desktop est installé dans C:\Program Files\Docker\Docker
.
Drapeaux de l'installateur
NoteSi vous utilisez PowerShell, vous devez utiliser le paramètre
ArgumentList
avant tous les drapeaux. Par exemple :Start-Process 'Docker Desktop Installer.exe' -Wait -ArgumentList 'install', '--accept-license'
Si votre compte admin est différent de votre compte utilisateur, vous devez ajouter l'utilisateur au groupe docker-users :
$ net localgroup docker-users <user> /add
La commande install
accepte les drapeaux suivants :
Comportement d'installation
--quiet
: Supprime la sortie d'informations lors de l'exécution de l'installateur--accept-license
: Accepte l'Accord de Service d'Abonnement Docker maintenant, plutôt que de l'exiger lors du premier lancement de l'application--installation-dir=<chemin>
: Change l'emplacement d'installation par défaut (C:\Program Files\Docker\Docker
)--backend=<nom du backend>
: Sélectionne le backend par défaut à utiliser pour Docker Desktop,hyper-v
,windows
ouwsl-2
(par défaut)--always-run-service
: Après la fin de l'installation, démarrecom.docker.service
et définit le type de démarrage du service sur Automatique. Cela contourne le besoin de privilèges administrateur, qui sont autrement nécessaires pour démarrercom.docker.service
.com.docker.service
est requis par les conteneurs Windows et le backend Hyper-V.
Sécurité et contrôle d'accès
--allowed-org=<nom org>
: Nécessite que l'utilisateur se connecte et fasse partie de l'organisation Docker Hub spécifiée lors de l'exécution de l'application--admin-settings
: Crée automatiquement un fichieradmin-settings.json
qui est utilisé par les administrateurs pour contrôler certains paramètres Docker Desktop sur les machines clientes au sein de leur organisation. Pour plus d'informations, voir Gestion des Paramètres.- Il doit être utilisé avec le drapeau
--allowed-org=<nom org>
. - Par exemple :
--allowed-org=<nom org> --admin-settings="{'configurationFileVersion': 2, 'enhancedContainerIsolation': {'value': true, 'locked': false}}"
- Il doit être utilisé avec le drapeau
--no-windows-containers
: Désactive l'intégration des conteneurs Windows. Cela peut améliorer la sécurité. Pour plus d'informations, voir Conteneurs Windows.
Configuration proxy
--proxy-http-mode=<mode>
: Définit le mode Proxy HTTP,system
(par défaut) oumanual
--override-proxy-http=<URL>
: Définit l'URL du proxy HTTP qui doit être utilisé pour les requêtes HTTP sortantes, nécessite que--proxy-http-mode
soitmanual
--override-proxy-https=<URL>
: Définit l'URL du proxy HTTP qui doit être utilisé pour les requêtes HTTPS sortantes, nécessite que--proxy-http-mode
soitmanual
--override-proxy-exclude=<hôtes/domaines>
: Contourne les paramètres proxy pour les hôtes et domaines. Utilise une liste séparée par des virgules.--proxy-enable-kerberosntlm
: Active l'authentification proxy Kerberos et NTLM. Si vous activez ceci, assurez-vous que votre serveur proxy est correctement configuré pour l'authentification Kerberos/NTLM. Disponible avec Docker Desktop 4.32 et ultérieur.
Racine des données et emplacement du disque
--hyper-v-default-data-root=<chemin>
: Spécifie l'emplacement par défaut pour le disque de la VM Hyper-V.--windows-containers-default-data-root=<chemin>
: Spécifie l'emplacement par défaut pour les conteneurs Windows.--wsl-default-data-root=<chemin>
: Spécifie l'emplacement par défaut pour le disque de la distribution WSL.
Démarrer Docker Desktop
Docker Desktop ne démarre pas automatiquement après l'installation. Pour démarrer Docker Desktop :
-
Recherchez Docker, et sélectionnez Docker Desktop dans les résultats de recherche.
-
Le menu Docker (
) affiche l'Accord de Service d'Abonnement Docker.
Voici un résumé des points clés :
- Docker Desktop est gratuit pour les petites entreprises (moins de 250 employés ET moins de 10 millions de dollars de chiffre d'affaires annuel), l'usage personnel, l'éducation et les projets open source non commerciaux.
- Sinon, il nécessite un abonnement payant pour un usage professionnel.
- Des abonnements payants sont également requis pour les entités gouvernementales.
- Les abonnements Docker Pro, Team et Business incluent l'utilisation commerciale de Docker Desktop.
-
Sélectionnez Accepter pour continuer. Docker Desktop démarre après que vous acceptiez les conditions.
Notez que Docker Desktop ne fonctionnera pas si vous n'acceptez pas les conditions. Vous pouvez choisir d'accepter les conditions à une date ultérieure en ouvrant Docker Desktop.
Pour plus d'informations, voir Accord de Service d'Abonnement Docker Desktop. Il est recommandé de lire les FAQ.
TipEn tant qu'administrateur IT, vous pouvez utiliser un logiciel de gestion des points de terminaison (MDM) pour identifier le nombre d'instances Docker Desktop et leurs versions dans votre environnement. Cela peut fournir un rapport de licence précis, aider à s'assurer que vos machines utilisent la dernière version de Docker Desktop, et vous permettre d' imposer la connexion.
Où aller ensuite
- Explorez les abonnements Docker pour voir ce que Docker peut vous offrir.
- Commencez avec Docker.
- Explorez Docker Desktop et toutes ses fonctionnalités.
- Dépannage décrit les problèmes courants, les contournements, et comment obtenir du support.
- FAQ fournissent des réponses aux questions fréquemment posées.
- Notes de version listent les mises à jour des composants, les nouvelles fonctionnalités et les améliorations associées aux versions Docker Desktop.
- Sauvegarder et restaurer les données fournit des instructions sur la sauvegarde et la restauration des données liées à Docker.
Depuis le menu Docker Desktop, vous pouvez basculer quel démon (Linux ou Windows) le CLI Docker utilise. Sélectionnez Basculer vers les conteneurs Windows pour utiliser les conteneurs Windows, ou sélectionnez Basculer vers les conteneurs Linux pour utiliser les conteneurs Linux (par défaut).
Pour plus d'informations sur les conteneurs Windows, référez-vous à la documentation suivante :
Documentation Microsoft sur les conteneurs Windows.
Construire et Exécuter Votre Premier Conteneur Windows Server (Article de Blog) donne un tour rapide de comment construire et exécuter des conteneurs Docker Windows natifs sur Windows 10 et les versions d'évaluation Windows Server 2016.
Commencer avec les Conteneurs Windows (Lab) vous montre comment utiliser l'application MusicStore avec des conteneurs Windows. Le MusicStore est une application .NET standard et, forkée ici pour utiliser des conteneurs, est un bon exemple d'application multi-conteneurs.
Pour comprendre comment se connecter aux conteneurs Windows depuis l'hôte local, voir Je veux me connecter à un conteneur depuis Windows
Si vous définissez des proxies ou une configuration de démon en mode conteneurs Windows, ceux-ci s'appliquent uniquement aux conteneurs Windows. Si vous rebasculez vers les conteneurs Linux, les proxies et configurations de démon reviennent à ce que vous aviez défini pour les conteneurs Linux. Vos paramètres de conteneurs Windows sont conservés et redeviennent disponibles lorsque vous rebasculez.