Un an de Nix sur macOS

2026-01-17T00:00:00+00:00
Je me souviens du moment exact où j'ai décidé d'essayer Nix. C'était un jeudi soir, vers 23h, et je fixais un terminal cassé après qu'une mise à jour macOS avait silencieusement réinitialisé mes préférences de dock, cassé trois liens symboliques Homebrew et, d'une manière ou d'une autre, changé mon Python par défaut. Encore une fois. J'entretenais mes dotfiles depuis janvier 2021 (plugins vim, thèmes zsh, configs git, tout le rituel) et tous les quelques mois, quelque chose arrêtait simplement... de fonctionner. Aucune raison claire. Juste des vibes.</p>
Alors le 17 janvier 2025, j'ai ajouté un flake.nix</code> à mon repo dotfiles. Je n'avais aucune idée de ce que je faisais.</p>
L'avant</a></h2>
Laisse-moi te décrire ce que j'avais. Un .zshrc</code> qui avait grandi de façon organique pendant quatre ans. Un Brewfile à peu près exact. Un install.sh</code> que j'avais écrit une fois, exécuté une fois, et plus jamais touché parce que j'avais peur de ce qu'il ferait. Des fichiers de config éparpillés dans ~/.config/</code> sans aucune trace claire de ceux que j'avais modifiés manuellement et de ceux qui venaient du repo.</p>
Le setup marchait</em>. Je pouvais écrire du code, pousser des commits, déployer des services. Mais à chaque fois que je devais configurer une nouvelle machine ou déboguer un chemin cassé, je passais une demi-journée à lire mon propre historique shell pour comprendre ce que j'avais fait six mois plus tôt.</p>
Le pire, c'était la situation des émulateurs de terminal. J'étais passé d'Alacritty à Kitty puis à Ghostty, et chaque migration laissait derrière elle des fichiers de config, des entrées PATH et des caches de polices que j'oubliais jusqu'à ce qu'ils causent un conflit bizarre.</p>
Découvrir Nix</a></h2>
Nix est un de ces outils que tout le monde décrit différemment. « C'est un gestionnaire de paquets. » « C'est un système de build. » « C'est un langage de programmation fonctionnel pour la configuration système. » Tout ça est techniquement vrai et rien de tout ça ne m'a aidé à comprendre pourquoi ça devrait m'intéresser.</p>
Ce qui a finalement cliqué, c'est ça : Nix te permet de décrire à quoi ton système devrait ressembler, puis il le rend conforme. Tu changes la description, il calcule le diff. Tu casses quelque chose, tu fais un rollback. Rien de plus.</p>
Sur macOS, nix-darwin</a> étend ça au niveau système (paquets Homebrew, paramètres macOS, mapping clavier, règles de pare-feu) et Home Manager</a> gère le niveau utilisateur (dotfiles, alias shell, variables d'environnement).</p>
Mon système, c'est maintenant deux fichiers et un Makefile. flake.nix</code> pour le système. home.nix</code> pour mon environnement utilisateur. make rebuild</code> pour tout appliquer. Pas de script d'installation. Pas d'étapes manuelles. Pas de « est-ce que j'ai pensé à lancer cette commande ».</p>
Comment ça s'est vraiment passé</a></h2>
Ça n'a pas été instantané. En regardant mon historique git, je peux tracer exactement comment ça s'est déroulé.</p>
Le premier flake.nix</code> en janvier 2025 était prudent. J'ai juste déplacé quelques paquets : neovim</code>, ripgrep</code>, jq</code>, rustup</code>. J'ai aussi ajouté nil</code> (le serveur de langage Nix) et nixfmt</code> parce qu'éditer des fichiers Nix sans outillage, c'est comme écrire du Rust sans rust-analyzer. Techniquement possible, pratiquement misérable.</p>
Deux mois plus tard j'ai ajouté Home Manager, et c'est là que tout a changé. Avant, je créais des liens symboliques avec un script shell en croisant les doigts. Maintenant je pouvais juste les déclarer :</p>
home</span>.</span>file</span>.</span>"</span>.config/ghostty/config</span>"</span>.</span>source</span> =</span> ./config/ghostty/config</span>;</span></span>
home</span>.</span>file</span>.</span>"</span>.config/git/config</span>"</span>.</span>source</span> =</span> ./config/git/config</span>;</span></span>
home</span>.</span>file</span>.</span>"</span>.config/zed/settings.json</span>"</span>.</span>source</span> =</span> ./config/zed/settings.json</span>;</span></span></code></pre>
Tu modifies le fichier source, tu lances make rebuild</code>, le lien symbolique se met à jour. Pas de ln -sf</code>. Pas besoin de vérifier si la cible existe. Pas de nettoyage de vieux liens de trois émulateurs de terminal.</p>
Puis en mai j'ai fait une erreur. J'ai essayé de gérer Homebrew entièrement via Nix avec un truc appelé nix-homebrew</code>. L'idée était belle : un seul système pour tout gouverner. La réalité était fragile. Homebrew veut vraiment posséder son propre état. Les taps, les tokens de cask, les cycles de mise à jour. Il a des opinions là-dessus, et se battre contre ces opinions causait plus de problèmes qu'il n'en résolvait.</p>
Alors j'ai tout viré. À la place, j'ai laissé nix-darwin gérer Homebrew déclarativement</em> sans essayer de le remplacer</em> :</p>
homebrew</span> =</span> {</span></span>
  enable</span> =</span> true</span>;</span></span>
  onActivation</span>.</span>cleanup</span> =</span> "</span>zap</span>"</span>;</span></span>
  onActivation</span>.</span>autoUpdate</span> =</span> true</span>;</span></span>
  onActivation</span>.</span>upgrade</span> =</span> true</span>;</span></span>
  brews</span> =</span> [</span> "</span>go</span>"</span> "</span>gh</span>"</span> "</span>lazygit</span>"</span> "</span>grpcurl</span>"</span> .</span>.</span>.</span> ]</span>;</span></span>
  casks</span> =</span> [</span> "</span>ghostty</span>"</span> "</span>zed</span>"</span> "</span>docker-desktop</span>"</span> .</span>.</span>.</span> ]</span>;</span></span>
}</span>;</span></span></code></pre>
Cette ligne onActivation.cleanup = "zap"</code> est la plus importante. Elle signifie : si un paquet n'est pas dans cette liste, supprime-le. Le flake devient la source de vérité. Si tu fais un brew install</code> manuellement, ça sera supprimé au prochain rebuild. Ça te force à tout déclarer. Au début c'était agaçant. Puis c'est devenu libérateur.</p>
Le weekend du PATH</a></h2>
Celui-ci mérite sa propre section parce qu'il m'a coûté deux jours et j'en suis encore un peu agacé.</p>
Nix et Homebrew veulent tous les deux contrôler ce qui est dans ton PATH. Le daemon Nix doit être sourcé avant tout le reste, mais le shellenv</code> de Homebrew modifie aussi le PATH. Si tu te trompes dans l'ordre, tu te retrouves à exécuter le git</code> système au lieu de celui de Homebrew, ou le python</code> de Homebrew au lieu de celui de pyenv</code>. J'ai passé beaucoup de temps à fixer la sortie de echo $PATH</code> avant d'arriver à ça :</p>
programs</span>.</span>zsh</span>.</span>shellInit</span> =</span> ''</span></span>
  if [ -e '/nix/var/nix/profiles/default/etc/profile.d/nix-daemon.sh' ]; then</span></span>
    . '/nix/var/nix/profiles/default/etc/profile.d/nix-daemon.sh'</span></span>
  fi</span></span>
  export PATH="/run/current-system/sw/bin:/nix/var/nix/profiles/default/bin:$PATH"</span></span>
''</span>;</span></span></code></pre>
Les chemins Nix d'abord, puis Homebrew via shellenv</code>, puis les chemins utilisateur. Simple avec le recul. Pas simple à 2h du matin.</p>
Là où c'est devenu fun</a></h2>
Une fois les fondations solides, vers octobre 2025, j'ai commencé à intégrer tout ce que je configurais manuellement avant. Les associations de fichiers (Zed comme éditeur par défaut pour 38 types de fichiers, avec duti</code>). Le remapping clavier (Caps Lock en Escape, parce que la vie est trop courte pour Caps Lock). Et celui qui m'a rendu irrationnellement heureux : les paramètres macOS.</p>
system</span>.</span>defaults</span> =</span> {</span></span>
  dock</span> =</span> {</span></span>
    autohide</span> =</span> true</span>;</span></span>
    autohide-delay</span> =</span> 0</span>.</span>0</span>;</span></span>
    autohide-time-modifier</span> =</span> 0</span>.</span>15</span>;</span></span>
    show-recents</span> =</span> false</span>;</span></span>
    tilesize</span> =</span> 60</span>;</span></span>
  }</span>;</span></span>
  NSGlobalDomain</span> =</span> {</span></span>
    AppleInterfaceStyle</span> =</span> "</span>Dark</span>"</span>;</span></span>
    InitialKeyRepeat</span> =</span> 14</span>;</span></span>
    KeyRepeat</span> =</span> 1</span>;</span></span>
    ApplePressAndHoldEnabled</span> =</span> false</span>;</span></span>
    NSAutomaticCapitalizationEnabled</span> =</span> false</span>;</span></span>
    NSAutomaticSpellingCorrectionEnabled</span> =</span> false</span>;</span></span>
  }</span>;</span></span>
}</span>;</span></span></code></pre>
La vitesse d'animation de mon dock se réinitialisait à chaque mise à jour macOS. J'oubliais, je le remarquais trois jours après, je googlais la commande defaults write</code>, je la lançais, je l'oubliais à nouveau. Maintenant make rebuild</code> gère ça. Pour toujours.</p>
La sécurité aussi est déclarative. Pare-feu en mode furtif, Touch ID pour sudo, signature GPG sur tous les commits. Tout dans le flake, tout reproductible.</p>
networking</span>.</span>applicationFirewall</span> =</span> {</span></span>
  enable</span> =</span> true</span>;</span></span>
  enableStealthMode</span> =</span> true</span>;</span></span>
}</span>;</span></span>
security</span>.</span>pam</span>.</span>services</span>.</span>sudo_local</span>.</span>touchIdAuth</span> =</span> true</span>;</span></span></code></pre>Le problème du daemon</a></h2>
Je dois être honnête là-dessus parce que personne d'autre ne semble en parler : le daemon Nix sur macOS est capricieux. Après des mises à jour système, des cycles veille/réveil, ou parfois sans aucune raison apparente, il arrête simplement de répondre. nix-store --version</code> se bloque. Tout casse.</p>
J'en ai eu marre de déboguer ça manuellement, alors j'ai écrit un script qui gère à la fois les installations Determinate Systems et les installations standard :</p>
if</span> [</span> -f</span> "</span>/Library/LaunchDaemons/systems.determinate.nix-store.plist</span>"</span> ]</span>;</span> then</span></span>
    sudo</span> launchctl</span> bootout</span> system/systems.determinate.nix-store</span></span>
    sudo</span> launchctl</span> bootstrap</span> system</span> /Library/LaunchDaemons/systems.determinate.nix-store.plist</span></span>
    sudo</span> launchctl</span> bootstrap</span> system</span> /Library/LaunchDaemons/systems.determinate.nix-daemon.plist</span></span>
fi</span></span></code></pre>
Le Makefile lance ça avant chaque rebuild. Ça ajoute environ une seconde. Ça vaut le coup de ne plus jamais penser au daemon.</p>
La frontière Homebrew</a></h2>
Après un an d'essais et d'erreurs, j'ai appris quelque chose que j'aurais aimé qu'on me dise dès le départ : n'essaie pas de remplacer Homebrew. Contrôle-le, c'est tout.</p>
Nix est parfait pour les binaires purs qui fonctionnent de manière identique sur toutes les plateformes. neovim</code>, ripgrep</code>, jq</code>, tree-sitter</code>. Mais dès que tu as besoin de quelque chose avec une compilation spécifique à macOS (comme postgresql@18</code>) ou d'une app graphique (comme Ghostty ou Zed), Homebrew est simplement meilleur. Se battre contre cette frontière fait perdre du temps. Le pattern onActivation.cleanup = "zap"</code> est la bonne réponse. Laisse Homebrew être Homebrew. Assure-toi juste que le flake décide de ce qu'il installe.</p>
J'ai perdu des semaines à apprendre ça à la dure. Toi, tu n'es pas obligé.</p>
Un an plus tard</a></h2>
Mon repo dotfiles a commencé en janvier 2021 avec des plugins vim et un zshrc. Cinq ans plus tard, c'est une spécification système complète et déclarative. J'ai configuré deux Macs à partir de zéro avec make rebuild</code>. Les deux ont pris moins de 20 minutes, la plupart du temps juste à attendre les téléchargements.</p>
Mais honnêtement, le scénario de la nouvelle installation n'arrive presque jamais. Le vrai gain est plus petit et plus fréquent. Une mise à jour macOS casse quelque chose ? Rebuild. Un nouveau projet a besoin d'un outil ? Une ligne, rebuild. Tu regrettes ? Rollback. Chaque changement est un commit. Chaque état est récupérable.</p>
C'est ce que Nix t'offre. Pas de la magie. Juste un système qui se souvient de ce à quoi il est censé ressembler, même quand toi tu ne t'en souviens plus.</p>
chukwuanu

Un an de Nix sur macOS
