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

Installer Docker Desktop sur Linux

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 contient des informations sur les exigences système générales, les plateformes prises en charge, et les instructions sur comment installer Docker Desktop pour Linux.

Important

Docker Desktop sur Linux exécute une Machine Virtuelle (VM) qui crée et utilise un contexte docker personnalisé, desktop-linux, au démarrage.

Cela signifie que les images et conteneurs déployés sur le moteur Docker Linux (avant l'installation) ne sont pas disponibles dans Docker Desktop pour Linux.

Important

Pour l'utilisation commerciale du moteur Docker obtenu via Docker Desktop dans les grandes entreprises (dépassant 250 employés ou avec un revenu annuel dépassant 10 millions USD), un abonnement payant est requis.

Docker Desktop pour Linux fournit une interface graphique conviviale qui simplifie la gestion des conteneurs et services. Il inclut le moteur Docker car c'est la technologie principale qui alimente les conteneurs Docker. Docker Desktop pour Linux vient également avec des fonctionnalités supplémentaires comme Docker Scout et les Extensions Docker.

Installation de Docker Desktop et du moteur Docker

Docker Desktop pour Linux et le moteur Docker peuvent être installés côte à côte sur la même machine. Docker Desktop pour Linux stocke les conteneurs et images dans un emplacement de stockage isolé au sein d'une VM et offre des contrôles pour restreindre ses ressources. L'utilisation d'un emplacement de stockage dédié pour Docker Desktop l'empêche d'interférer avec une installation du moteur Docker sur la même machine.

Bien qu'il soit possible d'exécuter Docker Desktop et le moteur Docker simultanément, il peut y avoir des situations où l'exécution des deux en même temps peut causer des problèmes. Par exemple, lors du mappage de ports réseau (-p / --publish) pour les conteneurs, Docker Desktop et le moteur Docker peuvent tous deux tenter de réserver le même port sur votre machine, ce qui peut conduire à des conflits ("port déjà utilisé").

Nous recommandons généralement d'arrêter le moteur Docker pendant que vous utilisez Docker Desktop pour empêcher le moteur Docker de consommer des ressources et pour prévenir les conflits décrits ci-dessus.

Utilisez la commande suivante pour arrêter le service du moteur Docker :

$ sudo systemctl stop docker docker.socket containerd

Selon votre installation, le moteur Docker peut être configuré pour démarrer automatiquement comme un service système lorsque votre machine démarre. Utilisez la commande suivante pour désactiver le service du moteur Docker, et pour l'empêcher de démarrer automatiquement :

$ sudo systemctl disable docker docker.socket containerd

Basculer entre Docker Desktop et le moteur Docker

Le CLI Docker peut être utilisé pour interagir avec plusieurs moteurs Docker. Par exemple, vous pouvez utiliser le même CLI Docker pour contrôler un moteur Docker local et pour contrôler une instance de moteur Docker distant s'exécutant dans le cloud. Les Contextes Docker vous permettent de basculer entre les instances de moteurs Docker.

Lors de l'installation de Docker Desktop, un contexte dédié "desktop-linux" est créé pour interagir avec Docker Desktop. Au démarrage, Docker Desktop définit automatiquement son propre contexte (desktop-linux) comme le contexte actuel. Cela signifie que les commandes CLI Docker suivantes ciblent Docker Desktop. À l'arrêt, Docker Desktop remet le contexte actuel au contexte default.

Utilisez la commande docker context ls pour voir quels contextes sont disponibles sur votre machine. Le contexte actuel est indiqué par un astérisque (*).

$ docker context ls
NAME            DESCRIPTION                               DOCKER ENDPOINT                                  ...
default *       Current DOCKER_HOST based configuration   unix:///var/run/docker.sock                      ...
desktop-linux                                             unix:///home/<user>/.docker/desktop/docker.sock  ...        

Si vous avez Docker Desktop et le moteur Docker installés sur la même machine, vous pouvez exécuter la commande docker context use pour basculer entre les contextes Docker Desktop et moteur Docker. Par exemple, utilisez le contexte "default" pour interagir avec le moteur Docker :

$ docker context use default
default
Current context is now "default"

Et utilisez le contexte desktop-linux pour interagir avec Docker Desktop :

$ docker context use desktop-linux
desktop-linux
Current context is now "desktop-linux"

Référez-vous à la documentation des Contextes Docker pour plus de détails.

Plateformes prises en charge

Docker fournit des paquets .deb et .rpm pour les distributions Linux suivantes et architectures :

Plateforme x86_64 / amd64
Ubuntu
Debian
Red Hat Enterprise Linux (RHEL)
Fedora

Un paquet expérimental est disponible pour les distributions basées sur Arch. Docker n'a pas testé ou vérifié l'installation.

Docker prend en charge Docker Desktop sur la version LTS actuelle des distributions susmentionnées et la version la plus récente. Lorsque de nouvelles versions sont rendues disponibles, Docker cesse de prendre en charge la version la plus ancienne et prend en charge la version la plus récente.

Exigences système générales

Pour installer Docker Desktop avec succès, votre hôte Linux doit répondre aux exigences générales suivantes :

  • Noyau 64-bit et support CPU pour la virtualisation.
  • Support de virtualisation KVM. Suivez les instructions de support de virtualisation KVM pour vérifier si les modules noyau KVM sont activés et comment fournir l'accès au périphérique KVM.
  • QEMU doit être version 5.2 ou ultérieure. Nous recommandons de mettre à niveau vers la dernière version.
  • Système d'initialisation systemd.
  • Environnement de bureau GNOME, KDE, ou MATE.
    • Pour de nombreuses distributions Linux, l'environnement GNOME ne prend pas en charge les icônes de barre d'état système. Pour ajouter le support des icônes de barre d'état système, vous devez installer une extension GNOME. Par exemple, AppIndicator.
  • Au moins 4 Go de RAM.
  • Activez la configuration du mappage d'ID dans les espaces de noms utilisateur, voir Partage de fichiers. Notez que pour Docker Desktop version 4.35 et ultérieure, ceci n'est plus requis.
  • Recommandé : Initialisez pass pour la gestion des identifiants.

Docker Desktop pour Linux exécute une Machine Virtuelle (VM). Pour plus d'informations sur pourquoi, voir Pourquoi Docker Desktop pour Linux exécute une VM.

Note

Docker ne fournit pas de support pour l'exécution de Docker Desktop pour Linux dans des scénarios de virtualisation imbriquée. Nous recommandons que vous exécutiez Docker Desktop pour Linux nativement sur les distributions prises en charge.

Support de virtualisation KVM

Docker Desktop exécute une VM qui nécessite le support KVM.

Le module kvm devrait se charger automatiquement si l'hôte a le support de virtualisation. Pour charger le module manuellement, exécutez :

$ modprobe kvm

Selon le processeur de la machine hôte, le module correspondant doit être chargé :

$ modprobe kvm_intel  # Processeurs Intel

$ modprobe kvm_amd    # Processeurs AMD

Si les commandes ci-dessus échouent, vous pouvez voir les diagnostics en exécutant :

$ kvm-ok

Pour vérifier si les modules KVM sont activés, exécutez :

$ lsmod | grep kvm
kvm_amd               167936  0
ccp                   126976  1 kvm_amd
kvm                  1089536  1 kvm_amd
irqbypass              16384  1 kvm

Configurer les permissions utilisateur du périphérique KVM

Pour vérifier la propriété de /dev/kvm, exécutez :

$ ls -al /dev/kvm

Ajoutez votre utilisateur au groupe kvm pour accéder au périphérique kvm :

$ sudo usermod -aG kvm $USER

Déconnectez-vous et reconnectez-vous pour que les changements prennent effet.

Choix du système de fichiers

Docker Desktop pour Linux prend en charge les deux systèmes de fichiers disponibles dans WSL 2 (ext4 et 9p), comme décrit dans la documentation Microsoft.

Si vous souhaitez améliorer les performances d'E/S de conteneur, vous pouvez configurer Docker Desktop pour qu'il utilise le système de fichiers ext4, qui est généralement plus rapide que le système de fichiers par défaut 9p. Pour plus d'informations, voir Modifier les paramètres.

Prochaines étapes

Sélectionnez votre distribution Linux pour obtenir des instructions d'installation spécifiques :

Une fois que vous avez installé Docker Desktop avec succès, vous pouvez vérifier les versions des binaires Docker en exécutant les commandes suivantes :

$ docker compose version
Docker Compose version v2.29.2

$ docker --version
Docker version 27.2.0, build 3ab4256

$ docker version
Client:
 Version:           27.2.0
 API version:       1.47
 Go version:        go1.21.13
 Git commit:        3ab4256
 Built:             Tue Aug 27 14:15:15 2024
 OS/Arch:           linux/amd64
 Context:           desktop-linux
...

Pour résoudre les problèmes qui peuvent survenir après l'installation, voir Dépannage.