Come installare Homebrew su Linux e WSL

Homebrew su Linux e su WSL è utile quando vuoi un gestore di pacchetti coerente tra macOS, Linux e ambienti di sviluppo Windows con sottosistema Linux. La parte importante è capire subito una cosa: non stai installando “una versione diversa” del tool, stai usando lo stesso modello di gestione pacchetti in due contesti operativi differenti. Su Linux puro l’obiettivo è avere binari e dipendenze installati nell’area utente senza impattare il sistema; su WSL il punto è evitare di mischiare troppo il mondo Linux con quello Windows, così da non ritrovarti con path sporchi, permessi strani o strumenti che si comportano in modo incoerente.

Se l’idea è usare Homebrew per sviluppo, automazione leggera o tool da linea di comando, la strada è lineare. Se invece vuoi sostituire il package manager della distribuzione, conviene fermarsi un attimo: Homebrew non nasce per rimpiazzare completamente apt, dnf o zypper, ma per offrire un flusso più prevedibile per software di terze parti e versioni specifiche. Su WSL il discorso è ancora più netto: Windows resta Windows, Linux resta Linux, e Homebrew vive nel filesystem Linux della distribuzione installata nel sottosistema.

Quando ha senso usare Homebrew su Linux e su WSL

Ha senso quando ti serve una raccolta di strumenti aggiornata, installabile senza privilegi root continui e facilmente replicabile su più macchine. È comodo per utility come git, jq, htop, fzf, ripgrep, client vari e tool di sviluppo che vuoi tenere separati dal set di pacchetti del sistema. In ambienti WSL torna utile anche per mantenere una base di lavoro coerente tra laptop diversi, o tra macchine con distribuzioni Linux differenti.

Non è invece la scelta giusta se ti aspetti che gestisca bene componenti strettamente integrati con il sistema operativo, demoni di sistema o software che dipende da policy distro-specifiche. In quei casi il package manager della distribuzione resta la prima opzione, perché gestisce aggiornamenti, dipendenze e integrazione in modo nativo.

Requisiti minimi prima di installare Homebrew

Prima di partire verifica di avere una shell moderna, strumenti base e una directory home scrivibile. Su Linux e su WSL Homebrew si appoggia a componenti standard come bash, curl, git e strumenti di compilazione minimi. Se mancano, l’installer te lo dirà, ma è meglio sapere in anticipo dove intervenire.

Controlli rapidi utili:

echo $HOME
uname -a
command -v curl git bash

Se il secondo comando mostra un kernel Linux dentro WSL, sei nel posto giusto. Se command -v non restituisce nulla per curl o git, installa i prerequisiti con il package manager della tua distribuzione prima di procedere.

Installazione standard su Linux

Il metodo ufficiale passa dallo script di installazione di Homebrew. È semplice, ma va usato con la stessa attenzione con cui useresti un qualsiasi bootstrap script: prima lo leggi, poi lo esegui. Il vantaggio è che l’installazione finisce in una posizione prevedibile, di solito sotto /home/linuxbrew/.linuxbrew o nel profilo utente, a seconda del contesto e dei privilegi disponibili.

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

Un controllo pratico che vale la pena fare subito è questo:

brew --version
brew doctor

Il primo deve restituire una versione; il secondo può segnalare avvisi, ma in condizioni sane non dovrebbe mostrarti errori bloccanti. Se brew non viene trovato, il problema è quasi sempre nel caricamento del profilo shell, non nell’installazione in sé.

Installazione su WSL senza mischiare Windows e Linux

Su WSL il principio è identico, ma c’è una regola pratica da non ignorare: installa Homebrew dentro la distribuzione Linux, non nel filesystem di Windows. In altre parole, lavora nel tuo ambiente Linux sotto WSL e lascia che Homebrew viva lì. Questo evita attriti con permessi, eseguibili e path che attraversano continuamente il confine tra i due mondi.

La sequenza è la stessa del Linux classico: aggiorna i prerequisiti, lancia l’installer, poi configura il percorso nella shell della distribuzione. La differenza vera è che su WSL spesso vale la pena controllare anche come apri il terminale: se usi più distribuzioni, assicurati di entrare sempre in quella giusta prima di installare, altrimenti ti ritrovi con Homebrew presente in una distro e assente nell’altra.

Un test rapido utile per evitare confusione tra ambienti è questo:

which brew
brew config

Il primo comando deve restituire un percorso coerente con il tuo ambiente Linux in WSL. Il secondo ti dice dove Homebrew pensa di trovarsi e quale architettura sta usando. Se il percorso sembra “ibrido” o passa da mount Windows, fermati: non è il setup giusto per lavorare bene nel medio periodo.

Problemi comuni dopo l’installazione

Il guasto più frequente non è l’installer, ma il PATH. Se apri una nuova shell e brew non esiste, la prima ipotesi è che il file di inizializzazione non venga letto, oppure che il blocco inserito dall’installer sia nel file sbagliato. Su bash e zsh questo capita spesso quando si modificano file diversi da quelli effettivamente caricati dalla sessione.

Secondo problema classico: dipendenze mancanti. L’installer può segnalare che servono strumenti di build o librerie di base. In quel caso la correzione non è reinstallare Homebrew, ma completare i prerequisiti della distribuzione e rilanciare il controllo con brew doctor.

Terzo tema: permessi e ownership della directory Homebrew. Se hai lanciato l’installazione in modo incoerente tra utente e root, o hai mischiato copie diverse del tool, puoi trovarti con file non scrivibili. La soluzione corretta non è “forzare” tutto con privilegi elevati, ma rimettere ordine nella directory di installazione e verificare chi possiede i file. In casi dubbi, conviene controllare il risultato di ls -ld sul percorso indicato da brew --prefix.

Verifiche dopo l’installazione

La verifica minima non è solo brew --version. Devi controllare che l’ambiente sia davvero usabile e non solo “installato”. Una sequenza sensata è questa:

brew --version
brew doctor
brew update
brew install git
git --version

Se brew update termina correttamente e brew install git installa senza errori, hai la prova che il ciclo base funziona: rete, repository, path e scrittura nella cellar sono a posto. Se invece l’installazione fallisce su un pacchetto semplice, il problema è quasi sempre locale: connessione, proxy, DNS, certificati o configurazione della shell.

Su WSL ha senso fare anche un controllo extra: apri una nuova finestra del terminale della stessa distribuzione e ripeti brew --version. Questo ti conferma che il setup non vive solo nella sessione corrente, ma è davvero persistente.

Come tenere pulito l’ambiente Homebrew nel tempo

Il modo migliore per non trasformare Homebrew in un groviglio è trattarlo come uno strumento di livello utente, non come un sostituto del sistema. Aggiorna con regolarità, evita di installare componenti che la distribuzione gestisce già in modo nativo e tieni separati i tool da sviluppo dai pacchetti di base del sistema operativo.

Se lavori sia su Linux sia su WSL, conviene standardizzare alcune abitudini: stessa shell, stessi file di configurazione, stesso set minimo di tool installati. In questo modo riduci i casi in cui una macchina funziona e l’altra no solo perché una legge ~/.bashrc e l’altra usa una sessione diversa o una shell differente.

Quando aggiorni Homebrew, osserva sempre l’output. Se compaiono warning su percorsi, permessi o tool mancanti, non ignorarli: sono quasi sempre il segnale di un problema che si manifesterà più avanti, magari nel momento peggiore, cioè quando devi installare in fretta un pacchetto per lavorare.

Disinstallazione e rollback pulito

Se vuoi rimuovere Homebrew, fallo in modo ordinato. Prima verifica che non ci siano pacchetti installati da conservare, poi usa il comando di uninstall ufficiale. Questo è particolarmente importante su WSL, dove potresti avere script o ambienti che dipendono da tool installati con Homebrew.

Il rollback pratico consiste nel rimuovere il blocco aggiunto al file di shell, cancellare la directory di installazione e verificare che il comando brew non sia più presente. Se hai usato Homebrew solo per alcuni strumenti di sviluppo, annota prima l’elenco dei pacchetti installati con brew list, così puoi ricostruire l’ambiente altrove se serve.

brew list
which brew

Se which brew continua a restituire un percorso dopo la rimozione, significa che nel PATH è rimasto un riferimento alla vecchia installazione oppure che esiste un secondo binario in un’altra posizione. In quel caso conviene cercare il file eseguibile reale e ripulire il profilo della shell.

In pratica: la regola che evita il 90% dei problemi

Su Linux e su WSL Homebrew funziona bene quando lo tratti per quello che è: un layer utente per tool e versioni di sviluppo, non un sostituto universale del package manager di sistema. Se l’installazione è pulita, il PATH è corretto e non mischi i confini tra Linux e Windows in WSL, il resto è abbastanza lineare.

Assunzione: distribuzione Linux recente, shell bash o zsh, Homebrew installato nell’ambiente Linux e non su filesystem Windows in WSL.