Homebrew : gérer vos logiciels sur macOS et Linux

Homebrew installe les logiciels que macOS (ou Linux) n’a pas, en une seule commande. Ce gestionnaire de paquets télécharge, compile si nécessaire, et installe plus de 10 000 formules (outils CLI) et casks (applications graphiques). Avec brew bundle, vous pouvez sauvegarder votre configuration complète dans un fichier Brewfile et la restaurer sur une nouvelle machine en quelques minutes. Homebrew 5.0 apporte la vérification des attestations SBOM et améliore les performances sur Apple Silicon.

Ce que vous allez apprendre

• Installer Homebrew sur macOS (Intel/Apple Silicon) et Linux
• Gérer vos paquets : installer, mettre à jour, supprimer
• Sauvegarder et restaurer votre configuration avec brew bundle
• Analyser les dépendances avec brew deps et brew uses
• Gérer les services (bases de données, serveurs) avec brew services
• Optimiser votre installation et résoudre les problèmes courants

Version actuelle

Ce guide utilise Homebrew 5.0.11 (janvier 2026). Homebrew 5.0 a introduit la vérification des attestations SBOM et des améliorations de performance.

Fonctionnement de Homebrew

Homebrew repose sur trois concepts clés :

Concept	Description	Exemple
Formule	Paquet CLI (outil en ligne de commande)	htop, git, node
Cask	Application graphique macOS	visual-studio-code, firefox
Tap	Dépôt externe de formules	homebrew/cask-fonts

Glissez pour voir

Où sont stockés les paquets ?

• macOS Apple Silicon : /opt/homebrew/Cellar/
• macOS Intel : /usr/local/Cellar/
• Linux : /home/linuxbrew/.linuxbrew/Cellar/

Installation de Homebrew

macOS

L’installation nécessite les Xcode Command Line Tools. macOS 11 (Big Sur) ou supérieur est recommandé.

1. Installer les outils de développement

   xcode-select --install

   Une boîte de dialogue apparaît pour confirmer l’installation.

2. Installer Homebrew

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. Configurer le PATH

   Pour Apple Silicon (M1/M2/M3/M4) :

   echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
   source ~/.zshrc

   Pour Intel :

   echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zshrc
   source ~/.zshrc

4. Vérifier l’installation

   brew doctor
   # Your system is ready to brew.

Linux

Sur Linux, Homebrew s’installe dans /home/linuxbrew/.linuxbrew. Vous aurez besoin de curl, git et des outils de compilation.

1. Installer les prérequis

   Sur Debian/Ubuntu :

   sudo apt update && sudo apt install -y build-essential curl git procps

   Sur Fedora :

   sudo dnf groupinstall -y 'Development Tools'
   sudo dnf install -y curl git procps-ng

2. Installer Homebrew

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. Configurer le PATH

   Pour bash :

   echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.bashrc
   source ~/.bashrc

   Pour zsh :

   echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.zshrc
   source ~/.zshrc

4. Vérifier l’installation

   brew doctor
   # Your system is ready to brew.

Commandes essentielles

Ces commandes couvrent 90% des usages quotidiens. Homebrew utilise une syntaxe simple : brew <action> <paquet>.

Installer un paquet

brew install htop
# ==> Pouring htop--3.4.1.arm64_sonoma.bottle.tar.gz
# 🍺  /opt/homebrew/Cellar/htop/3.4.1: 13 files, 597.3KB

Pour les applications graphiques macOS, ajoutez --cask :

brew install --cask visual-studio-code

Rechercher un paquet

brew search python
# ==> Formulae
# python@3.11  python@3.12  python@3.13  micropython  ipython

Obtenir les informations d’un paquet

brew info htop
# ==> htop: stable 3.4.1 (bottled)
# Improved top (interactive process viewer)
# https://htop.dev/
# Installed: /opt/homebrew/Cellar/htop/3.4.1

Mettre à jour Homebrew et les paquets

# Mettre à jour le catalogue des formules
brew update

# Voir les paquets obsolètes
brew outdated

# Mettre à jour tous les paquets
brew upgrade

# Mettre à jour un paquet spécifique
brew upgrade htop

Supprimer un paquet

brew uninstall htop

Pour supprimer aussi les dépendances orphelines :

brew autoremove

Lister les paquets installés

# Tous les paquets
brew list

# Seulement les formules (CLI)
brew list --formula

# Seulement les casks (GUI)
brew list --cask

# Paquets "feuilles" (installés explicitement, pas en dépendance)
brew leaves

Nettoyer les anciennes versions

Homebrew conserve les anciennes versions après une mise à jour. Pour libérer de l’espace :

# Simuler le nettoyage (dry-run)
brew cleanup -n
# Would remove: /opt/homebrew/Cellar/node/20.10.0 (1,234 files, 89MB)

# Nettoyer effectivement
brew cleanup

Résumé des commandes de base

Action	Commande
Installer un paquet CLI	brew install <paquet>
Installer une app GUI	brew install --cask <app>
Rechercher	brew search <terme>
Informations	brew info <paquet>
Mettre à jour le catalogue	brew update
Mettre à jour les paquets	brew upgrade
Supprimer	brew uninstall <paquet>
Lister les paquets	brew list
Nettoyer	brew cleanup
Diagnostic	brew doctor

Glissez pour voir

Sauvegarder et restaurer avec Brewfile

brew bundle permet de sauvegarder votre configuration complète dans un fichier déclaratif appelé Brewfile. C’est essentiel pour :

• Configurer rapidement une nouvelle machine
• Versionner votre configuration dans un dotfiles repo
• Partager une configuration d’équipe

Créer un Brewfile

# Générer le Brewfile depuis les paquets installés
brew bundle dump
# Fichier Brewfile créé dans le répertoire courant

Le fichier généré ressemble à :

# Brewfile
tap "homebrew/bundle"
tap "homebrew/cask-fonts"

# CLI tools
brew "git"
brew "htop"
brew "node"
brew "python@3.12"

# GUI applications
cask "visual-studio-code"
cask "firefox"
cask "docker"

# Fonts
cask "font-fira-code"

Restaurer depuis un Brewfile

# Installer tous les paquets du Brewfile
brew bundle install

# Ou simplement
brew bundle

Vérifier la cohérence

# Voir ce qui serait installé sans rien faire
brew bundle check

# Lister les paquets installés mais absents du Brewfile
brew bundle cleanup --dry-run

# Supprimer ces paquets excédentaires
brew bundle cleanup

Astuce DevOps

Versionnez votre Brewfile dans un dépôt Git avec vos dotfiles. Ajoutez un script bootstrap.sh qui lance brew bundle automatiquement.

Analyser les dépendances

Comprendre les dépendances est crucial pour le nettoyage et le diagnostic. Homebrew fournit plusieurs commandes pour visualiser les relations entre paquets.

Voir les dépendances d’un paquet

brew deps htop
# lm-sensors
# ncurses

Afficher l’arbre des dépendances

brew deps --tree htop
# htop
# ├── ncurses
# └── lm-sensors

Voir tous les paquets qui dépendent d’un autre

brew uses --installed ncurses
# htop

Cette commande est utile avant de désinstaller un paquet partagé.

Lister les paquets orphelins

Les paquets “feuilles” sont ceux que vous avez installés explicitement (pas en tant que dépendance) :

brew leaves

Pour voir les dépendances qui ne sont plus nécessaires :

brew autoremove --dry-run

Gérer les services

Sur macOS, brew services utilise launchd pour démarrer des services au login. C’est pratique pour les bases de données, serveurs web, etc.

# Lister tous les services disponibles
brew services list
# Name       Status  User File
# postgresql stopped
# redis      started bob  ~/Library/LaunchAgents/homebrew.mxcl.redis.plist

# Démarrer un service
brew services start postgresql

# Arrêter un service
brew services stop postgresql

# Redémarrer un service
brew services restart postgresql

# Démarrer au boot (avec sudo)
sudo brew services start postgresql

Linux

Sur Linux, brew services utilise systemd si disponible. Sinon, les services doivent être gérés manuellement.

Gérer les dépôts externes (Taps)

Les taps sont des dépôts Git contenant des formules supplémentaires. Par défaut, Homebrew utilise homebrew/core et homebrew/cask.

Lister les taps installés

homebrew/bundle

brew tap
# homebrew/cask

Ajouter un tap

brew tap hashicorp/tap

Une fois ajouté, vous pouvez installer les formules de ce tap :

brew install hashicorp/tap/terraform

Supprimer un tap

brew untap hashicorp/tap

Taps utiles

Tap	Description
homebrew/cask-fonts	Polices pour développeurs
hashicorp/tap	Outils HashiCorp (Terraform, Vault)
aws/tap	AWS CLI et outils
mongodb/brew	MongoDB Community

Glissez pour voir

Gérer plusieurs versions

Installer une version spécifique

Certains paquets proposent plusieurs versions avec le suffixe @version :

brew search python
# python@3.11  python@3.12  python@3.13

brew install python@3.11

Figer une version (pin)

Pour empêcher la mise à jour d’un paquet :

# Bloquer les mises à jour
brew pin python@3.12

# Voir les paquets bloqués
brew list --pinned
# python@3.12

# Débloquer
brew unpin python@3.12

Basculer entre versions

Si plusieurs versions sont installées, utilisez brew link :

# Désactiver la version actuelle
brew unlink python@3.12

# Activer une autre version
brew link python@3.11 --force

Gestion avancée des versions

Pour une gestion plus fine des versions (Node.js, Python, Ruby…), considérez asdf-vm qui permet de définir des versions par projet.

Dépannage

Commandes de diagnostic

# Vérifier la configuration
brew doctor

# Voir la configuration actuelle
brew config

# Recréer les liens symboliques
brew link <paquet> --overwrite

# Réinstaller un paquet corrompu
brew reinstall <paquet>

Problèmes courants et solutions

Symptôme	Cause probable	Solution
command not found: brew	PATH non configuré	Relancer le shellenv (voir installation)
Permission denied	Problème de propriétaire	sudo chown -R $(whoami) /opt/homebrew
Error: No available formula	Catalogue obsolète	brew update
Bottle not found	Version de macOS non supportée	brew install --build-from-source <pkg>
Cask requires macOS	Cask sur Linux	Les casks sont réservés à macOS
already installed	Paquet déjà présent	brew reinstall <pkg> si besoin

Glissez pour voir

Réparer une installation cassée

# Réinitialiser Homebrew (garde les paquets)
brew update-reset

# Nettoyer le cache
brew cleanup --prune=all

# Vérifier et réparer les liens
brew doctor

Bonnes pratiques

Sécurité

• Vérifiez les formules avant d’ajouter un tap tiers
• Ne jamais utiliser sudo avec brew (sauf pour brew services)
• Les attestations SBOM (Homebrew 5.0+) vérifient l’intégrité des bottles

Performance

• Nettoyez régulièrement : brew cleanup libère l’espace disque
• Utilisez brew bundle pour des installations reproductibles
• Évitez d’installer tout : chaque paquet consomme des ressources

Organisation

• Un Brewfile par projet si les dépendances diffèrent
• Versionnez votre Brewfile dans votre repo dotfiles
• Documentez les taps externes que vous utilisez

À retenir

1. brew install installe des outils CLI, --cask pour les apps GUI
2. brew bundle dump sauvegarde votre configuration dans un Brewfile
3. brew bundle install restaure tout depuis ce fichier
4. brew deps --tree visualise les dépendances d’un paquet
5. brew services gère les services (bases de données, serveurs)
6. brew pin bloque les mises à jour d’un paquet spécifique
7. brew doctor diagnostique les problèmes de configuration

D’autres outils ?

asdf-vm : gérer les versions Gestionnaire de versions pour Node, Python, Ruby et plus

Docker Conteneuriser vos applications

Plus d’infos

• Site officiel Homebrew — Documentation et téléchargement
• Homebrew Formulae — Catalogue des paquets
• Homebrew Bundle — Documentation Brewfile
• Releases Homebrew — Notes de version

×

📖 Voir la documentation →