Veelgestelde problemen

`brew install wget` en dan werkt het. Tenzij je op een Mac zit waar nog nooit iets vanaf de command line is geïnstalleerd, want dan mis je eerst de Xcode Command Line Tools, en dan mislukt diezelfde opdracht met een foutmelding die je drie keer moet lezen voor je begrijpt dat er niets aan de hand is met Homebrew zelf.

Homebrew is de package manager voor macOS en Linux. Dit artikel installeert hem op macOS 14 (Sonoma) of 15 (Sequoia), zet de omgeving op orde en laat zien hoe je formulae, casks en services beheert. Voor wie net een Mac heeft en de terminal serieus wil gebruiken, of voor wie al jaren `brew install` typt zonder te weten wat er onder de motorkap gebeurt.

Vereisten

• macOS 14 of 15. Op oudere versies werkt Homebrew nog, maar de Apple Silicon-paden gaan uit van recente releases.
• Een administrator-account. Het installatiescript vraagt om je wachtwoord voor `sudo`.
• Xcode Command Line Tools. Homebrew installeert ze zo nodig zelf, maar je kunt het ook vooraf doen.
• Een werkende internetverbinding. Het script haalt alles van GitHub.

Op Intel-Macs installeert Homebrew in `/usr/local`. Op Apple Silicon (M1 en later) in `/opt/homebrew`. Dat verschil bepaalt later je `PATH`, dus onthoud op welk type machine je zit.

Stappen

1. Installeer de Xcode Command Line Tools

Deze tools bevatten `git`, `make`, `clang` en de headers die Homebrew nodig heeft om software uit broncode te bouwen.

```bash xcode-select --install ```

Er opent een dialoogvenster. Klik door en wacht tot het klaar is. Dit duurt een paar minuten en je kunt er niets aan versnellen. Sla je deze stap over, dan vraagt het Homebrew-script er alsnog om, midden in de installatie.

2. Installeer Homebrew

Het officiële script downloadt Homebrew en zet het op de juiste plek.

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

Het script toont eerst wat het gaat doen en vraagt om bevestiging. Lees dat door. Het vraagt ook je `sudo`-wachtwoord, want het maakt mappen aan in `/opt/homebrew` of `/usr/local`.

Gebruik alleen dit script. Er circuleren varianten die extra's beloven; die voer je niet uit met systeemrechten.

3. Zet Homebrew in je PATH

Op Apple Silicon staat `brew` niet automatisch in je `PATH`. Het script zegt dit aan het eind van de installatie, maar het is makkelijk te missen tussen de regels door.

Voor Apple Silicon:

```bash echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile eval "$(/opt/homebrew/bin/brew shellenv)" ```

Voor Intel:

```bash echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile eval "$(/usr/local/bin/brew shellenv)" ```

De eerste regel schrijft de instelling naar `~/.zprofile`, zodat elke nieuwe shell hem oppikt. De tweede regel activeert hem in je huidige sessie. Zonder deze stap krijg je `command not found: brew` in elke nieuwe terminal.

4. Werk de package-lijsten bij

Homebrew houdt lokale lijsten bij van wat beschikbaar is. Die zijn na installatie niet actueel.

```bash brew update ```

Dit haalt de nieuwste formulae en casks op uit de repositories. Doe dit voordat je iets installeert, anders zoek je in een verouderde lijst. Het commando duurt normaal een paar seconden en is daarna lang stil als er niets te updaten valt.

5. Installeer een command-line tool

`wget` zit niet standaard op macOS. Het is een goed testpakket.

```bash brew install wget ```

Homebrew lost afhankelijkheden zelf op. Heb je een formule nodig die van OpenSSL afhangt, dan installeert hij die erbij. Dat is het grootste voordeel ten opzichte van handmatig compileren: je hoeft nooit zelf uit te zoeken welke versie van welke library erbij hoort.

6. Installeer een grafische applicatie via cask

Casks zijn de manier om desktop-apps te installeren. Ze pakken een `.dmg` of `.pkg` uit en zetten de app in `/Applications`.

```bash brew install --cask firefox ```

Dit is functioneel hetzelfde als Firefox van de website plukken en naar Applications slepen, maar dan herhaalbaar. Het nadeel: niet elke app is als cask beschikbaar, en de versie loopt soms achter op wat de ontwikkelaar zelf uitgeeft. Voor de meeste tools maakt dat niets uit.

7. Beheer achtergronddiensten

Databases en webservers wil je als service laten draaien, niet handmatig starten na elke reboot.

```bash brew install postgresql@16 brew services start postgresql@16 ```

`brew services` koppelt het proces aan launchd, het systeem dat macOS gebruikt voor achtergrondtaken. Het verschil met handmatig starten: de service komt terug na een reboot. Dat is precies wat je wilt voor een database, en precies wat je niet wilt voor iets wat je één keer nodig had.

8. Leg je omgeving vast in een Brewfile

Een Brewfile is een platte tekst met alles wat je geïnstalleerd hebt. Handig na een herinstallatie of op een tweede machine.

```bash brew bundle dump ```

Dit schrijft een `Brewfile` in je huidige map. Op een andere machine zet je hem terug met:

```bash brew bundle install ```

Wat het kost: het bestand bevat ook pakketten die je ooit uitprobeerde en nooit opruimde. Ruim je Brewfile op voor je hem deelt, anders sleep je jaren aan rommel mee naar je volgende Mac.

Verificatie

Controleer of alles werkt en op de juiste plek staat.

```bash brew --version brew doctor ```

`brew --version` toont het versienummer en het installatiepad. `brew doctor` loopt je omgeving na en meldt problemen. Een schone installatie geeft "Your system is ready to brew." Krijg je waarschuwingen, lees ze dan echt; ze wijzen vaak op een `PATH` die nog naar een oude Intel-installatie op een Apple Silicon-Mac wijst.

Controleer daarna wat je geïnstalleerd hebt:

```bash brew list --formula brew list --cask brew services list ```

Veelgestelde problemen

`command not found: brew` na een nieuwe terminal. De `shellenv`-regel staat niet in je shellprofiel, of je gebruikt een andere shell dan zsh. Zet de regel uit stap 3 in het bestand dat bij jouw shell hoort.

`Error: Cannot install under Rosetta 2`. Je draait een Intel-versie van de terminal op een Apple Silicon-Mac. Open Terminal via Finder, cmd-I, en zet "Open using Rosetta" uit. Herstart de terminal en installeer opnieuw.

`brew install` blijft hangen bij "Updating Homebrew". Dit is meestal netwerk of GitHub-rate-limiting. Probeer het later opnieuw of zet `HOMEBREW_NO_AUTO_UPDATE=1` voor die ene opdracht als je zeker weet dat je lijsten actueel zijn.

Homebrew is niet de enige optie. MacPorts bestaat langer en installeert alles in een eigen boomstructuur, wat schoner is maar ook trager en minder populair. Voor de meeste mensen op macOS is Homebrew de pragmatische keuze: het dekt wat je nodig hebt, en als het een keer misgaat, staat de oplossing op Stack Overflow.