Installation sur macOS
Le Cask Homebrew docker-desktop (token canonique) installe Docker Desktop, qui embarque le moteur, le client, Compose et une interface graphique. Attention : brew install docker SANS l'option --cask installe la CLI seule (formule), pas l'application Docker Desktop. Après l'installation par brew, vous devez lancer l'application au moins une fois : elle démarre une machine virtuelle Linux légère (via le framework de virtualisation d'Apple) dans laquelle le démon s'exécute. Tant que l'application n'est pas lancée, docker ps renvoie une erreur de connexion au démon.
Acceptez l'autorisation système demandée au premier lancement : Docker Desktop a besoin d'un composant privilégié pour gérer le socket et le réseau.
Une fois l'application lancée, vérifiez que le moteur répond. docker --version n'affiche que la version du client ; pour prouver que le démon fonctionne réellement, exécutez docker run --rm hello-world (sans sudo). Cette commande télécharge une petite image, lance un conteneur et le supprime aussitôt.
Apple Silicon et architectures
Sur les Mac Apple Silicon (M1/M2/M3…), les conteneurs s'exécutent par défaut en arm64. Pour lancer une image amd64 (x86_64), utilisez l'option de plateforme, par exemple docker run --platform linux/amd64 …. Par défaut, cette émulation repose sur l'émulateur logiciel QEMU. Rosetta n'est utilisé que si vous activez explicitement l'option correspondante dans les réglages de Docker Desktop ; il n'est donc pas employé automatiquement. Dans tous les cas l'émulation fonctionne mais reste plus lente ; privilégiez les images multi-architectures lorsque c'est possible.
Pièges fréquents
Ne confondez pas le Cask docker-desktop (Docker Desktop) avec la formule CLI. Si vous aviez installé la formule docker (binaire client seul, via brew install docker sans --cask), elle peut entrer en conflit dans le PATH. Vérifiez avec which docker que la commande pointe bien vers l'installation de Docker Desktop.