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

Référence des paramètres

Table des matières

Cette référence liste tous les paramètres Docker Desktop, y compris où ils sont configurés, quels systèmes d'exploitation ils concernent, et s'ils sont disponibles dans l'interface graphique Docker Desktop, la Console d'Administration Docker, ou le fichier admin-settings.json. Les paramètres sont groupés pour correspondre à la structure de l'interface Docker Desktop.

Chaque paramètre inclut :

  • Le nom d'affichage utilisé dans Docker Desktop
  • Un tableau des valeurs, valeurs par défaut, et format requis
  • Une description et des cas d'usage
  • Compatibilité OS
  • Méthodes de configuration : via Docker Desktop, la Console d'Administration, ou le fichier admin-settings.json

Utilisez cette référence pour comparer comment les paramètres se comportent à travers différentes méthodes de configuration et plateformes.

Général

Démarrer Docker Desktop quand vous vous connectez à votre ordinateur

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Démarrer Docker Desktop automatiquement lors du démarrage de la machine.
  • OS : Tous
  • Cas d'usage : S'assurer que Docker Desktop fonctionne toujours après le démarrage.
  • Configurer ce paramètre avec :

Ouvrir le Tableau de bord Docker quand Docker Desktop démarre

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Ouvrir le Tableau de bord Docker automatiquement quand Docker Desktop démarre.
  • OS : Tous
  • Cas d'usage : Accéder rapidement aux conteneurs, images, et volumes dans le Tableau de bord Docker après avoir démarré Docker Desktop.
  • Configurer ce paramètre avec :

Choisir le thème pour Docker Desktop

Valeur par défaut Valeurs acceptées Format
system light, dark, system Enum
  • Description : Choisir le thème de l'interface graphique Docker Desktop.
  • OS : Tous
  • Cas d'usage : Personnaliser l'apparence de Docker Desktop.
  • Configurer ce paramètre avec :

Configurer les complétions shell

Valeur par défaut Valeurs acceptées Format
integrated integrated, system String
  • Description : Si installé, édite automatiquement votre configuration shell.
  • OS : Tous
  • Cas d'usage : Personnaliser l'expérience développeur avec les complétions shell.
  • Configurer ce paramètre avec :

Choisir le terminal conteneur

Valeur par défaut Valeurs acceptées Format
integrated integrated, system String
  • Description : Sélectionner le terminal par défaut pour lancer Docker CLI depuis Docker Desktop.
  • OS : Tous
  • Cas d'usage : Personnaliser l'expérience développeur avec le terminal préféré.
  • Configurer ce paramètre avec :

Activer le terminal Docker

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Activer l'accès au terminal intégré Docker Desktop. Si la valeur est définie à false, les utilisateurs ne peuvent pas utiliser le terminal Docker pour interagir avec la machine hôte et exécuter des commandes directement depuis Docker Desktop.
  • OS : Tous
  • Cas d'usage : Permettre ou restreindre l'accès développeur au terminal intégré.
  • Configurer ce paramètre avec :

Activer Docker Debug par défaut

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Activer la journalisation de débogage par défaut pour les commandes Docker CLI.
  • OS : Tous
  • Cas d'usage : Aider au débogage des problèmes de support.
  • Configurer ce paramètre avec :

Inclure la VM dans la sauvegarde Time Machine

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Sauvegarder la machine virtuelle Docker Desktop.
  • OS : Mac uniquement
  • Cas d'usage : Gérer la persistance des données d'application.
  • Configurer ce paramètre avec :

Utiliser containerd pour tirer et stocker les images

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Utiliser le snapshotter natif containerd au lieu des snapshotters hérités.
  • OS : Tous
  • Cas d'usage : Améliorer les performances et la compatibilité de gestion des images.
  • Configurer ce paramètre avec :

Choisir le gestionnaire de machine virtuelle

Docker VMM

Valeur par défaut Valeurs acceptées Format
true true, false Boolean

Apple Virtualization framework

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Utiliser le Framework de Virtualisation Apple pour exécuter des conteneurs Docker.
  • OS : Mac uniquement
  • Cas d'usage : Améliorer les performances de la machine virtuelle (VM) sur Apple Silicon.
  • Configurer ce paramètre avec :

Rosetta

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Utiliser Rosetta pour émuler amd64 sur Apple Silicon. Si la valeur est définie à true, Docker Desktop active Rosetta pour accélérer l'émulation binaire x86_64/amd64 sur Apple Silicon.
  • OS : Mac uniquement 13+
  • Cas d'usage : Exécuter des conteneurs basés sur Intel sur des hôtes Apple Silicon.
Note

Dans les environnements durcis, désactivez et verrouillez ce paramètre pour ne permettre que des images natives ARM.

Note

Rosetta nécessite l'activation du Framework de Virtualisation Apple.

QEMU

Valeur par défaut Valeurs acceptées Format
true true, false Boolean

Choisir le partage de fichiers implémentation

VirtioFS

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Utiliser VirtioFS pour le partage de fichiers rapide et natif entre l'hôte et les conteneurs. Si la valeur est définie à true, VirtioFS est défini comme mécanisme de partage de fichiers. Si VirtioFS et gRPC sont définis à true, VirtioFS prend le dessus.
  • OS : Mac uniquement 12.5+
  • Cas d'usage : Améliorer les performances et la compatibilité de montage de volume.
Note

Dans les environnements durcis, activez et verrouillez ce paramètre pour macOS 12.5 et plus tard.

gRPC FUSE

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Activer gRPC FUSE pour le partage de fichiers macOS. Si la valeur est définie à true, gRPC Fuse est défini comme mécanisme de partage de fichiers.
  • OS : Mac uniquement
  • Cas d'usage : Améliorer les performances et la compatibilité de montage de fichiers.
Note

Dans les environnements durcis, désactivez et verrouillez ce paramètre.

osxfs

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Activer le pilote de partage de fichiers osxfs hérité pour macOS. Lorsque défini à true, Docker Desktop utilise osxfs au lieu de VirtioFS ou gRPC FUSE pour monter les répertoires hôtes dans les conteneurs.
  • OS : Mac uniquement
  • Cas d'usage : Utiliser la mise en œuvre de partage de fichiers originale lorsque la compatibilité avec les outils ou workflows plus anciens ou spécifiques est requise.
  • Configurer ce paramètre avec :

Envoyer des statistiques d'utilisation

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Contrôle si Docker Desktop collecte et envoie des statistiques d'utilisation locales et des rapports de crash à Docker. Ce paramètre affecte la télémétrie collectée à partir de l'application Docker Desktop elle-même. Il n'affecte pas la télémétrie collectée par le serveur à partir de Docker Hub ou d'autres services back-end, tels que les horodatages de connexion, les pulls ou les builds.
  • OS : Tous
  • Cas d'usage : Activer l'analyse pour aider Docker à améliorer le produit en fonction des données d'utilisation.
Note

Dans les environnements durcis, désactivez et verrouillez ce paramètre. Cela vous permet de contrôler tous vos flux de données et de collecter des journaux de support via des canaux sécurisés si nécessaire.

Note

Les organisations utilisant le Tableau de bord Insights peuvent avoir besoin de ce paramètre activé pour s'assurer que l'activité du développeur est entièrement visible. Si les utilisateurs optent out et que le paramètre n'est pas verrouillé, leur activité peut être exclue des vues d'analyse.

Utiliser l'isolation renforcée des conteneurs

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Activer l'isolation renforcée des conteneurs pour l'exécution sécurisée des conteneurs.
  • OS : Tous
  • Cas d'usage : Empêcher les conteneurs de modifier la configuration ou les zones hôtes sensibles.
Note

Dans les environnements durcis, désactivez et verrouillez ce paramètre.

Afficher les indices CLI

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Afficher des indices CLI utiles dans le terminal lors de l'utilisation des commandes Docker.
  • OS : Tous
  • Cas d'usage : Aider les utilisateurs à découvrir et à apprendre les fonctionnalités Docker CLI via des suggestions en ligne.
  • Configurer ce paramètre avec :

Activer l'analyse d'image Scout

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Activer Docker Scout pour générer et afficher les données SBOM pour les images de conteneurs.
  • OS : Tous
  • Cas d'usage : Activer les fonctionnalités d'analyse Docker Scout pour voir les vulnérabilités, packages, et métadonnées associées aux images.
Note

Dans les environnements durcis, activez et verrouillez ce paramètre pour s'assurer que les SBOM sont toujours construites pour satisfaire les scans de conformité.

Activer l'indexation SBOM Scout en arrière-plan

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Indexer automatiquement les données SBOM pour les images en arrière-plan sans nécessiter d'interaction utilisateur.
  • OS : Tous
  • Cas d'usage : Maintenir les métadonnées d'image à jour en permettant à Docker d'effectuer l'indexation SBOM pendant le temps d'inactivité ou après les opérations de tirage d'image.
Note

Dans les environnements durcis, activez et verrouillez ce paramètre.

Vérifier automatiquement la configuration

Valeur par défaut Valeurs acceptées Format
CurrentSettingsVersions Integer Integer
  • Description : Vérifie régulièrement votre configuration pour s'assurer qu'aucun changement inattendu n'a été effectué par une autre application
  • OS : Tous
  • Cas d'usage : Suivre les versions pour la compatibilité
  • Configurer ce paramètre avec :

Ressources

Limite CPU

Valeur par défaut Valeurs acceptées Format
Nombre de cœurs CPU logiques disponibles sur l'hôte Integer Integer
  • Description : Nombre de CPU assignés à la machine virtuelle Docker Desktop.
  • OS : Tous
  • Cas d'usage : Contrôle de l'allocation des ressources.
  • Configurer ce paramètre avec :

Limite mémoire

Valeur par défaut Valeurs acceptées Format
Basé sur les ressources système Integer Integer
  • Description : Quantité de RAM (en MiB) assignée à la machine virtuelle Docker.
  • OS : Tous
  • Cas d'usage : Contrôler combien de mémoire Docker peut utiliser sur l'hôte.
  • Configurer ce paramètre avec :

Swap

Valeur par défaut Valeurs acceptées Format
1024 Integer Integer
  • Description : Quantité d'espace de swap (en MiB) assignée à la machine virtuelle Docker
  • OS : Tous
  • Cas d'usage : Étendre la disponibilité mémoire via le swap
  • Configurer ce paramètre avec :

Limite d'utilisation disque

Valeur par défaut Valeurs acceptées Format
Taille de disque par défaut de la machine. Integer Integer

  • Description : Taille de disque maximale (en MiB) allouée pour Docker Desktop.

  • OS : Tous

  • Cas d'usage : Contraindre la taille du disque virtuel de Docker pour la gestion du stockage.

  • Configurer ce paramètre avec :

  • Description : Activer Docker Scout pour générer et afficher des données SBOM pour les images de conteneur.

  • OS : Tous

  • Cas d'usage : Activer les fonctionnalités d'analyse Scout Docker pour afficher les vulnérabilités, les packages et les métadonnées associées aux images.

Note

Dans les environnements durcis, activez et verrouillez ce paramètre pour s'assurer que les SBOM sont toujours construits pour satisfaire les analyses de conformité.

Activer l'indexation SBOM en arrière-plan Scout

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Indexer automatiquement les données SBOM pour les images en arrière-plan sans nécessiter d'interaction de l'utilisateur.
  • OS : Tous
  • Cas d'usage : Maintenir à jour les métadonnées des images en permettant à Docker de réaliser l'indexation SBOM pendant le temps inactif ou après les opérations de pull d'image.
Note

Dans les environnements durcis, activez et verrouillez ce paramètre.

Vérifier automatiquement la configuration

Valeur par défaut Valeurs acceptées Format
CurrentSettingsVersions Integer Integer
  • Description : Vérifier régulièrement votre configuration pour vous assurer qu'aucun changement inattendu n'a été apporté par une application autre que Docker.
  • OS : Tous
  • Cas d'usage : Suivre les versions pour la compatibilité
  • Configurer ce paramètre avec :

Ressources

Limite CPU

Valeur par défaut Valeurs acceptées Format
Nombre de cœurs logiques disponibles sur l'hôte Integer Integer
  • Description : Nombre de cœurs CPU affectés à la machine virtuelle Docker Desktop.
  • OS : Tous
  • Cas d'usage : Contrôler l'allocation des ressources.
  • Configurer ce paramètre avec :

Limite de mémoire

Valeur par défaut Valeurs acceptées Format
Basé sur les ressources système Integer Integer
  • Description : Quantité de RAM (en Mo) affectée à la machine virtuelle Docker.
  • OS : Tous
  • Cas d'usage : Contrôler combien de mémoire Docker peut utiliser sur l'hôte.
  • Configurer ce paramètre avec :

Swap

Valeur par défaut Valeurs acceptées Format
1024 Integer Integer
  • Description : Quantité d'espace swap (en Mo) affectée à la machine virtuelle Docker
  • OS : Tous
  • Cas d'usage : Étendre la disponibilité de la mémoire via le swap
  • Configurer ce paramètre avec :

Limite d'utilisation du disque

Valeur par défaut Valeurs acceptées Format
Taille disque par défaut de la machine. Integer Integer
  • Description : Taille maximale du disque (en Mo) allouée pour Docker Desktop.
  • OS : Tous
  • Cas d'usage : Constrainer la taille du disque virtuel Docker sur le stockage.
  • Configurer ce paramètre avec :

Emplacement de l'image disque

Valeur par défaut Valeurs acceptées Format
macOS: ~/Library/Containers/com.docker.docker/Data/vms/0
Windows: %USERPROFILE%\AppData\Local\Docker\wsl\data		 File path String
  • Description : Chemin où Docker Desktop stocke les données de la machine virtuelle.
  • OS : Tous
  • Cas d'usage : Rediriger les données Docker vers un emplacement personnalisé.
  • Configurer ce paramètre avec :

Activer le sauvegarde de ressources

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Activer Docker Desktop pour mettre en pause lorsqu'il est inactif.
  • OS : Tous
  • Cas d'usage : Sauvegarder les ressources système pendant les périodes d'inactivité.
  • Configurer ce paramètre avec :

Répertoires de partage de fichiers

Valeur par défaut Valeurs acceptées Format
Varies by OS List of file paths as strings Array list of strings
  • Description : Liste des répertoires autorisés partagés entre l'hôte et les conteneurs. Lorsqu'un chemin est ajouté, ses sous-répertoires sont autorisés.
  • OS : Tous
  • Cas d'usage : Restreindre ou définir les chemins de fichiers disponibles pour les conteneurs.
Note

Dans les environnements durcis, verrouillez à une liste explicite et désactivez les éditions utilisateur finales.

Exclure proxy

Valeur par défaut Valeurs acceptées Format
"" List of addresses String
  • Description : Configurer les adresses que les conteneurs doivent ignorer des paramètres proxy
  • OS : Tous
  • Cas d'usage : Affiner les exceptions proxy pour le réseau de conteneurs.
Note

Dans les environnements durcis, désactivez et verrouillez ce paramètre.

Sous-réseau Docker

Valeur par défaut Valeurs acceptées Format
192.168.65.0/24 IP address String
  • Description : Remplacer la plage de réseau utilisée pour le DHCP/DNS vpnkit
  • OS : Mac uniquement
  • Cas d'usage : Personnaliser le sous-réseau utilisé pour le réseau de conteneurs Docker.
  • Configurer ce paramètre avec :

Utiliser le réseau kernel pour UDP

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Utiliser le réseau kernel hôte's pour le trafic UDP au lieu du réseau virtuel Docker driver. Cela permet un accès plus rapide et plus direct au trafic UDP, mais peut ignorer certaines fonctionnalités d'isolation des conteneurs.
  • OS : Tous
  • Cas d'usage : Améliorer les performances ou la compatibilité pour les charges de travail qui dépendent fortement du trafic UDP, tels que les médias en temps réel, le DNS ou les serveurs de jeu.
  • Configurer ce paramètre avec :

Activer le réseau hôte

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Activer le support de réseau hôte expérimental.
  • OS : Tous
  • Cas d'usage : Permettre aux conteneurs d'utiliser le réseau stack hôte.
  • Configurer ce paramètre avec :

Mode de réseau

Valeur par défaut Valeurs acceptées Format
dual-stack ipv4only, ipv6only String
  • Description : Définir le mode de réseau.
  • OS : Windows et Mac
  • Cas d'usage : Choisir le protocole IP par défaut utilisé lorsque Docker crée de nouveaux réseaux.
  • Configurer ce paramètre avec :

Pour plus d'informations, voir Réseau.

Inhiber la résolution DNS pour IPv4/IPv6

Valeur par défaut Valeurs acceptées Format
auto ipv4, ipv6, none String
  • Description : Filtrer les types d'enregistrement DNS non pris en charge.
  • OS : Windows et Mac
  • Cas d'usage : Contrôler comment Docker filtre les enregistrements DNS renvoyés aux conteneurs, améliorant la fiabilité dans les environnements où seul IPv4 ou IPv6 est pris en charge.
  • Configurer ce paramètre avec :

Pour plus d'informations, voir Réseau.

Activer le moteur WSL

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Si la valeur est définie à true, Docker Desktop utilise le moteur basé sur WSL2. Cela remplace tout ce qui aurait été défini lors de l'installation en utilisant la ligne de commande --backend=<backend name>.
  • OS : Windows uniquement + WSL
  • Cas d'usage : Activer les conteneurs Linux via le backend WSL 2.
Note

Dans les environnements durcis, activez et verrouillez ce paramètre.

Docker Engine

Les paramètres Docker Engine vous permettent de configurer les paramètres de bas niveau du daemon Docker via un objet JSON brut. Ces paramètres sont transmis directement au processus dockerd qui gère la gestion des conteneurs dans Docker Desktop.

Key Example Description Accepted values / Format Default
debug true Activer la journalisation détaillée dans le daemon Docker Boolean false
experimental true Activer les fonctionnalités Docker CLI et daemon expérimentales Boolean false
insecure-registries ["myregistry.local:5000"] Permettre de tirer des images HTTP de registres sans TLS Array of strings (host:port) []
registry-mirrors ["https://mirror.gcr.io"] Définir des points de terminaison de registre alternatifs Array of URLs []
  • Description : Personnaliser le comportement du daemon Docker en utilisant une configuration JSON structurée transmise directement à dockerd.
  • OS : Tous
  • Cas d'usage : Affiner l'accès au registre, activer le mode débogage ou opt-in pour les fonctionnalités expérimentales.
  • Configurer ce paramètre avec :
Note

Les valeurs de ce paramètre sont transmises telles quelles au daemon Docker. Les champs non valides ou non pris en charge peuvent empêcher Docker Desktop de démarrer.

Constructeurs

Les paramètres Constructeurs vous permettent de gérer les instances Constructeur Buildx pour les scénarios de construction d'image avancés, y compris les constructions multi-plateformes et les backends personnalisés.

Key Example Description Accepted values / Format Default
name "my-builder" Nom de l'instance Constructeur String —
driver "docker-container" Backend utilisé par le Constructeur (docker, docker-container, remote, etc.) String docker
platforms ["linux/amd64", "linux/arm64"] Plateformes cibles prises en charge par le Constructeur Array of platform strings Host arch
  • Description : Configurer les Constructeurs Docker Desktop personnalisés, y compris le type de pilote et les plateformes prises en charge.
  • OS : Tous
  • Cas d'usage : Configurer des configurations de construction avancées comme des images multi-plateformes ou des constructeurs distants.
  • Configurer ce paramètre avec :
Note

Les définitions Constructeur sont structurées sous forme de tableau d'objets, chaque objet décrivant une instance Constructeur. Les configurations conflictuelles ou non prises en charge peuvent causer des erreurs de construction.

Kubernetes

Activer Kubernetes

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Activer le cluster Kubernetes intégré dans Docker Desktop.
  • OS : Tous
  • Cas d'usage : Activer ou désactiver le support Kubernetes pour les développeurs.
Note

Dans les environnements durcis, désactivez et verrouillez ce paramètre.

Choisir la méthode de provisionnement de cluster

Valeur par défaut Valeurs acceptées Format
kubeadm kubeadm, kind String
  • Description : Définir le mode de nœud Kubernetes (nœud unique ou multi-nœud).
  • OS : Tous
  • Cas d'usage : Contrôler la topologie du cluster Kubernetes intégré.
  • Configurer ce paramètre avec :

Nombre de nœuds Kubernetes (provisionnement kind)

Valeur par défaut Valeurs acceptées Format
1 Integer Integer
  • Description : Nombre de nœuds à créer dans un cluster Kubernetes multi-nœud.
  • OS : Tous
  • Cas d'usage : Mettre à l'échelle le nombre de nœuds Kubernetes pour le développement ou le test.
  • Configurer ce paramètre avec :

Version de nœud Kubernetes (provisionnement kind)

Valeur par défaut Valeurs acceptées Format
1.31.1 Version sémantique (par exemple, 1.29.1) String
  • Description : Version de Kubernetes utilisée pour la création de nœud de cluster.
  • OS : Tous
  • Cas d'usage : Référencer une version spécifique de Kubernetes pour la cohérence ou la compatibilité.
  • Configurer ce paramètre avec :

Afficher les conteneurs du système

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Afficher les conteneurs du système Kubernetes dans la liste des conteneurs du Tableau de bord Docker
  • OS : Tous
  • Cas d'usage : Permettre aux développeurs de voir les conteneurs kube-system pour le débogage
Note

Dans les environnements durcis, désactivez et verrouillez ce paramètre.

Mise à jour du logiciel

Vérifier automatiquement les mises à jour

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Désactiver la mise à jour automatique de Docker Desktop. Si la valeur est définie à true, la mise à jour et les notifications sur les mises à jour de Docker Desktop sont désactivées.
  • OS : Tous
  • Cas d'usage : Geler la version actuelle dans les environnements d'entreprise.
Note

Dans les environnements durcis, activez ce paramètre et verrouillez. Cela garantit que seules les versions vérifiées sont installées.

Toujours télécharger les mises à jour

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Télécharger automatiquement les mises à jour Docker Desktop lorsqu'elles sont disponibles.
  • OS : Tous
  • Cas d'usage : Gérer le comportement de mise à jour automatique.
  • Configurer ce paramètre avec :

Extensions

Activer les extensions Docker

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Activer ou désactiver les extensions Docker.
  • OS : Tous
  • Cas d'usage : Contrôler l'accès au Marketplace Extensions et les extensions installées.
Note

Dans les environnements durcis, désactivez et verrouillez ce paramètre. Cela empêche l'installation de plugins tiers ou non vérifiés.

Autoriser uniquement les extensions distribuées via le Docker Marketplace

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Restreindre Docker Desktop à n'exécuter que les extensions Marketplace.
  • OS : Tous
  • Cas d'usage : Empêcher l'exécution de troisièmes partis ou extensions locales.
  • Configurer ce paramètre avec :

Afficher les conteneurs système extensions Docker

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Afficher les conteneurs système utilisés par les extensions Docker dans la liste des conteneurs
  • OS : Tous
  • Cas d'usage : Aider les développeurs à résoudre des problèmes ou à afficher les conteneurs système des extensions
  • Configurer ce paramètre avec :

Fonctionnalités bêta

Important

Pour Docker Desktop versions 4.41 et antérieures, ces paramètres vivaient sous l'onglet Fonctionnalités en développement de la page Fonctionnalités en développement.

Activer Docker AI

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Activer les fonctionnalités AI dans l'expérience Docker Desktop.
  • OS : Tous
  • Cas d'usage : Activer ou désactiver les fonctionnalités AI comme "Demander Gordon".
  • Configurer ce paramètre avec :

Activer le moteur de construction d'image Docker

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Activer les fonctionnalités du moteur de construction d'image Docker dans Docker Desktop.
  • OS : Tous
  • Cas d'usage : Activer ou désactiver les fonctionnalités du moteur de construction d'image Docker.
  • Configurer ce paramètre avec :

Activer le support TCP hôte

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Activer les fonctionnalités du moteur de construction d'image Docker dans Docker Desktop.
  • OS : Tous
  • Cas d'usage : Activer ou désactiver les fonctionnalités du moteur de construction d'image Docker.
  • Configurer ce paramètre avec :
Note

Ce paramètre nécessite que le paramètre du moteur de construction d'image Docker soit activé en premier.

Activer le kit de construction Docker MCP

Valeur par défaut Valeurs acceptées Format
true true, false Boolean

Activer Wasm

Valeur par défaut Valeurs acceptées Format
true true, false Boolean

Activer le pont de composition

Valeur par défaut Valeurs acceptées Format
true true, false Boolean

Notifications

Mises à jour de statut des tâches et processus

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Afficher des messages d'information générale à l'intérieur de Docker Desktop
  • OS : Tous
  • Cas d'usage : Personnaliser la visibilité de la communication in-app
  • Configurer ce paramètre avec :

Recommandations de Docker

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Afficher des annonces promotionnelles et des bannières à l'intérieur de Docker Desktop
  • OS : Tous
  • Cas d'usage : Contrôler l'exposition aux annonces Docker et la promotion des fonctionnalités
  • Configurer ce paramètre avec :

Annonces Docker

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Afficher des annonces générales à l'intérieur de Docker Desktop.
  • OS : Tous
  • Cas d'usage : Activer ou supprimer les annonces Docker-wide dans l'interface graphique.
  • Configurer ce paramètre avec :

Enquêtes Docker

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Afficher les notifications invitant les utilisateurs à participer à des enquêtes
  • OS : Tous
  • Cas d'usage : Activer ou désactiver les invites de questionnaire in-product
  • Configurer ce paramètre avec :

Pop-ups de notification Docker Scout

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Activer les pop-ups Docker Scout à l'intérieur de Docker Desktop.
  • OS : Tous
  • Cas d'usage : Afficher ou masquer les notifications de scan de vulnérabilité
  • Configurer ce paramètre avec :

Notifications OS Docker Scout

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Activer les notifications Docker Scout via le système d'exploitation.
  • OS : Tous
  • Cas d'usage : Pousser les mises à jour Scout via le centre de notification du système
  • Configurer ce paramètre avec :

Avancé

Configurer l'installation de Docker CLI

Valeur par défaut Valeurs acceptées Format
system File path String
  • Description : Emplacement d'installation pour les binaires Docker CLI.
  • OS : Tous
  • Cas d'usage : Personnaliser l'emplacement d'installation CLI pour la conformité ou l'outillage.
  • Configurer ce paramètre avec :

Autoriser le socket Docker par défaut à être utilisé

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Par défaut, l'isolation renforcée des conteneurs bloque le montage du socket Docker dans les conteneurs (e.g., docker run -v /var/run/docker.sock:/var/run/docker.sock ...). Cela vous permet de relaxer cela de manière contrôlée. Voir la configuration ECI pour plus d'informations.
  • OS : Tous
  • Cas d'usage : Permettre aux conteneurs d'accéder au socket Docker pour des scénarios comme Docker-in-Docker ou des agents CI conteneurisés.
  • Configurer ce paramètre avec :

Autoriser le mappage de port privilégié

Valeur par défaut Valeurs acceptées Format
true true, false Boolean
  • Description : Démarrer le processus d'aide privilégié qui lie les ports privilégiés entre 1 et 1024
  • OS : Mac uniquement
  • Cas d'usage : Enforcez les privilèges élevés pour le support réseau
  • Configurer ce paramètre avec :

Paramètres non disponibles dans l'interface graphique Docker Desktop

Les paramètres suivants ne sont pas affichés dans l'interface graphique Docker Desktop. Vous ne pouvez les configurer qu'en utilisant la Gestion des Paramètres avec la Console d'Administration ou le fichier admin-settings.json.

Bloquer docker load

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Empêcher les utilisateurs de charger des images Docker locales en utilisant la commande docker load.
  • OS : Tous
  • Cas d'usage : Enforcez la provenance des images en restreignant les importations d'images locales.
Note

Dans les environnements durcis, activez et verrouillez ce paramètre. Cela force tous les images à venir de votre registre sécurisé, analysé.

Exposer l'API Docker sur TCP 2375

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Expose l'API Docker sur un socket TCP non authentifié sur le port 2375. Seulement recommandé pour les environnements isolés et protégés.
  • OS : Windows uniquement
  • Cas d'usage : Requis pour les intégrations de compatibilité ou les environnements sans support de tuyau nommé.
Note

Dans les environnements durcis, désactivez et verrouillez ce paramètre. Cela garantit que Docker API n'est accessible que via le socket interne sécurisé.

Proxy de conteneur air-gappé

Valeur par défaut Valeurs acceptées Format
See example Object JSON object
  • Description : Configurer un proxy HTTP/HTTPS manuel pour les conteneurs. Utiles dans les environnements air-gappés où les conteneurs ont besoin d'accès restreint.
  • OS : Tous
  • Cas d'usage : Rediriger ou bloquer le réseau de conteneurs pour se conformer aux environnements hors ligne ou sécurisés.
  • Configurer ce paramètre avec :

Exemple 

"containersProxy": {
  "locked": true,
  "mode": "manual",
  "http": "",
  "https": "",
  "exclude": [],
  "pac": "",
  "transparentPorts": ""
}

Contrôle d'accès au socket Docker (exceptions ECI)

Valeur par défaut Valeurs acceptées Format
- Object JSON object
  • Description : Permettre des images ou des commandes spécifiques d'utiliser le socket Docker lorsque l'isolation renforcée des conteneurs est activée.
  • OS : Tous
  • Cas d'usage : Soutenir les outils comme Testcontainers ou LocalStack qui ont besoin d'accéder au socket Docker tout en maintenant des défauts sécurisés.
  • Configurer ce paramètre avec:

Exemple 

"enhancedContainerIsolation": {
  "locked": true,
  "value": true,
  "dockerSocketMount": {
    "imageList": {
      "images": [
        "docker.io/localstack/localstack:*",
        "docker.io/testcontainers/ryuk:*"
      ]
    },
    "commandList": {
      "type": "deny",
      "commands": ["push"]
    }
  }
}

Autoriser les fonctionnalités bêta

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Activer l'accès aux fonctionnalités bêta dans Docker Desktop.
  • OS : Tous
  • Cas d'usage : Donner aux développeurs un accès précoce aux fonctionnalités qui sont en version bêta publique.
Note

Dans les environnements durcis, désactivez et verrouillez ce paramètre.

Options du daemon Docker (Linux ou Windows)

Valeur par défaut Valeurs acceptées Format
{} JSON object Stringified JSON
  • Description : Remplacer la configuration du daemon Docker utilisée dans les conteneurs Linux ou Windows.
  • OS : Tous
  • Cas d'usage : Configurer les options de bas niveau du daemon Docker (par exemple, les journaux, les pilotes de stockage) sans modifier les fichiers de configuration locaux.
Note

Dans les environnements durcis, fournir une configuration JSON vérifiée et la verrouiller pour que aucun les remplacements sont possibles.

  • Configurer ce paramètre avec :

CIDR VPNKit

Valeur par défaut Valeurs acceptées Format
192.168.65.0/24 CIDR notation String
  • Description : Définir le sous-réseau utilisé pour les services VPNKit DHCP/DNS internes.
  • OS : Mac uniquement
  • Cas d'usage : Empêcher les conflits IP dans les environnements avec des sous-réseaux superposés.
Note

Dans les environnements durcis, verrouillez à un CIDR approuvé, non conflictuel.

Activer l'authentification Kerberos et NTLM

Valeur par défaut Valeurs acceptées Format
false true, false Boolean
  • Description : Activer l'authentification proxy Kerberos et NTLM pour les environnements d'entreprise.
  • OS : Tous
  • Cas d'usage : Permettre aux utilisateurs d'authentifier avec des serveurs proxy d'entreprise qui requièrent Kerberos ou NTLM.
  • Configurer ce paramètre avec :