⚠️ Traduction non officielle - Cette documentation est une traduction communautaire non officielle de Docker.

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

Tip

Dois-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 :

Pour plus d'informations sur la configuration de WSL 2 avec Docker Desktop, voir WSL.

Note

Docker 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.

Important

Pour 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 :

Note

Docker 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.

Important

Pour 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 :
Important

Les 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.

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 :

Note

Lorsque vous basculez vers les conteneurs Windows, Paramètres n'affiche que les onglets qui sont actifs et s'appliquent à vos conteneurs 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.

Installer Docker Desktop sur Windows

Tip

Voir les FAQ sur comment installer et exécuter Docker Desktop sans avoir besoin de privilèges administrateur.

Installation interactive

  1. Téléchargez l'installateur en utilisant le bouton de téléchargement en haut de la page, ou depuis les notes de version.

  2. Double-cliquez sur Docker Desktop Installer.exe pour exécuter l'installateur. Par défaut, Docker Desktop est installé dans C:\Program Files\Docker\Docker.

  3. 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.

  4. Suivez les instructions de l'assistant d'installation pour autoriser l'installateur et procéder à l'installation.

  5. Lorsque l'installation est réussie, sélectionnez Fermer pour terminer le processus d'installation.

  6. Démarrez Docker Desktop.

Si votre compte administrateur est différent de votre compte utilisateur, vous devez ajouter l'utilisateur au groupe docker-users :

  1. Exécutez Gestion de l'ordinateur en tant qu'administrateur.
  2. Naviguez vers Utilisateurs et groupes locaux > Groupes > docker-users.
  3. Clic droit pour ajouter l'utilisateur au groupe.
  4. 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

Note

Si 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 ou wsl-2 (par défaut)
  • --always-run-service : Après la fin de l'installation, démarre com.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émarrer com.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 fichier admin-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}}"
  • --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) ou manual
  • --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 soit manual
  • --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 soit manual
  • --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 :

  1. Recherchez Docker, et sélectionnez Docker Desktop dans les résultats de recherche.

  2. Le menu Docker ( menu baleine ) 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.
  3. 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.

Tip

En 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