Installer Docker sur macOS, sans Docker Desktop

14 oct. 2025

Antoine CALLOT

Couteau suisse IT

Introduction

Saviez-vous que vous n’êtes pas obligé d’avoir Docker Desktop pour utiliser Docker sous macOS ? Docker Desktop est une application graphique lourde, consommatrice de ressources, et désormais soumise à une licence payante pour certaines entreprises.

Installation

Nettoyage après Docker Desktop

Si vous aviez déjà Docker Desktop installé, il est important de supprimer la configuration liée à son gestionnaire de credentials. Ouvrez le fichier ~/.docker/config.json et supprimez la ligne suivante :

"credsStore": "desktop",

Exemple :

{
  "auths": {},
  "credsStore": "desktop",
  "currentContext": "colima",
  "plugins": {
    "debug": {
      "hooks": "exec"
    },
    "scout": {
      "hooks": "pull,buildx build"
    }
  },
  "features": {
    "hooks": "true"
  }
}

Une fois cette ligne supprimée, la CLI Docker utilisera le bon gestionnaire d’identifiants.

Installation de Colima et Docker

L’installation de Docker sans Docker Desktop repose sur la CLI Docker et Colima (la machine virtuelle Linux), on peut ajouter quelques outils complémentaires comme docker-compose.

Commencez par installer le client Docker en ligne de commande, dans mon cas j’utilise homebrew comme gestionnaire de paquets :

brew install docker

Cette commande installe uniquement la CLI Docker, sans moteur de conteneur. Pour exécuter des conteneurs, nous aurons besoin de Colima.

Installez ensuite Colima, qui fournira la machine virtuelle Linux nécessaire au fonctionnement de Docker :

brew install colima

Une fois installé, lancez Colima avec la commande suivante :

colima start

Pour vérifier que tout fonctionne correctement :

docker ps

Si la commande renvoie une liste (même vide), Docker est bien opérationnel sur votre Mac sans Docker Desktop.

Enfin, installez docker-compose et docker-credential-helper :

brew install docker-compose docker-credential-helper

Ces outils assurent la compatibilité avec les projets qui utilisent docker-compose.yml et la gestion sécurisée des identifiants.

Pensez également à créer un lien vers votre socket docker, afin que les applications qui utilise le socket ne soit pas perdu :

sudo ln -sf $HOME/.colima/default/docker.sock /var/run/docker.sock

Pourquoi installer Colima ?

Sur macOS, Docker ne peut pas s’exécuter nativement, car il a besoin d’un environnement Linux. Docker Desktop fournit cette couche via une VM, Colima remplit le même rôle de manière plus légère, open source et intégrée à la CLI.

Colima agit comme un remplaçant minimaliste de la machine virtuelle de Docker Desktop, en utilisant un moteur comme containerd ou Docker Engine, tout en gérant automatiquement les contextes et la configuration réseau.

Mettre Colima et Docker au reboot

Pour lancer Colima au démarrage, vous pouvez utiliser Homebrew :

brew services start colima

Vous pouvez vérifier qu’il démarre bien :

brew services list

Conclusion

En suivant ces étapes, vous disposez désormais d’un environnement Docker complet sur macOS, sans passer par Docker Desktop. Grâce à Colima, vous bénéficiez d’une solution légère, rapide et open source. Vous économisez aussi des licences Docker Desktop.

Installer Docker sur macOS, sans Docker Desktop

Introduction

Installation

Nettoyage après Docker Desktop

Installation de Colima et Docker

Pourquoi installer Colima ?

Mettre Colima et Docker au reboot

Conclusion

Sources (si disponible)