Come installare Homebrew su Amazon Linux 2023

Su Amazon Linux 2023 Homebrew si installa senza grossi problemi, ma conviene farlo con un minimo di disciplina: prima verifichi i prerequisiti, poi installi i pacchetti base, quindi aggiungi il binario al PATH dell’utente corretto e chiudi con un controllo pulito. Il punto chiave è non trattarlo come un pacchetto “di sistema”: Homebrew vive nel profilo utente, quindi va tenuto separato da configurazioni globali e da privilegi inutili.

Quando ha senso usare Homebrew su Amazon Linux 2023

Amazon Linux 2023 è pensato soprattutto per workload server-side, ma in molti casi serve un gestore pacchetti più flessibile per installare utility recenti, tool di sviluppo, client di test o dipendenze non disponibili nei repository di base. Homebrew è utile quando vuoi evitare di compilare a mano, quando ti servono versioni aggiornate di strumenti come git, wget, jq, oppure quando lavori su una macchina di amministrazione e vuoi un ambiente coerente tra più sistemi.

Non è invece la scelta giusta se vuoi gestire software di produzione come servizio di sistema, o se ti aspetti che sostituisca dnf. Su Linux, Homebrew deve restare uno strumento complementare, non il centro della gestione del sistema operativo.

Prerequisiti: cosa controllare prima di installarlo

Amazon Linux 2023 è una distribuzione moderna, ma la procedura resta sensibile a tre cose: architettura supportata, pacchetti base presenti e permessi dell’utente che farà l’installazione. Prima di partire, verifica che la macchina sia una x86_64 o una arm64 compatibile con Homebrew e che l’utente abbia una home directory scrivibile.

Un controllo rapido evita quasi tutti gli intoppi iniziali:

uname -m
cat /etc/os-release
id
pwd

Atteso: uname -m restituisce x86_64 oppure aarch64; /etc/os-release identifica Amazon Linux 2023; id mostra l’utente effettivo, non root, salvo casi particolari. Se stai lavorando come amministratore, è preferibile installare Homebrew per un utente dedicato o per l’account operativo che lo userà davvero.

Pacchetti di base richiesti su Amazon Linux 2023

Su Amazon Linux 2023 servono gli strumenti standard per scaricare e compilare il minimo necessario. In pratica, prima installi o verifichi i pacchetti richiesti da Homebrew e dai suoi script di bootstrap.

Se il sistema è minimale, esegui:

sudo dnf install -y curl file git gcc glibc make procps-ng

La lista può variare leggermente in base a cosa hai già presente, ma questi pacchetti coprono i casi più comuni. curl serve per il bootstrap, git per il repository Homebrew, gli strumenti di compilazione per eventuali formule che richiedono build locali. Se uno di questi pacchetti non si installa, il problema non è Homebrew: va risolto prima a livello di repository o di sistema.

Installazione di Homebrew con lo script ufficiale

La strada più lineare è usare lo script ufficiale di installazione. Su Linux il comando crea la directory di installazione sotto /home/linuxbrew/.linuxbrew oppure nel percorso previsto dalla distribuzione Homebrew, e poi ti indica come aggiornare il PATH.

L’installazione tipica è questa:

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

Qui il rischio operativo è basso, ma va comunque considerato: stai eseguendo uno script remoto. Prima di farlo in ambienti sensibili, è sensato leggere lo script, oppure almeno recuperarlo e ispezionarlo localmente. Il prerequisito minimo è avere accesso HTTPS corretto e un utente con home scrivibile.

Se vuoi evitare il pipe diretto, puoi scaricarlo e verificarlo prima:

curl -fsSLo install.sh https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh
less install.sh
/bin/bash install.sh

Questo approccio è più prudente quando lavori su server condivisi o in ambienti con policy strette. Il rollback, in questo caso, è semplice: se decidi di annullare l’installazione, puoi rimuovere la directory Homebrew e le righe di inizializzazione aggiunte ai file di shell dell’utente.

PATH e inizializzazione della shell

Dopo l’installazione, Homebrew ti stampa quasi sempre le istruzioni per aggiungere il suo binario al PATH. Questo passaggio è fondamentale: se non lo fai, il comando brew non sarà trovato, oppure sarà visibile solo in una shell e non in un’altra.

Su Linux, il percorso tipico è questo:

eval "$($(brew --prefix)/bin/brew shellenv)"

Attenzione: il comando sopra funziona solo dopo che brew esiste già. Se vuoi renderlo permanente, aggiungilo al file di inizializzazione della shell dell’utente, ad esempio ~/.bashrc o ~/.bash_profile, a seconda del flusso di login usato sulla macchina.

Per Bash, una configurazione tipica è questa:

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

Se preferisci evitare percorsi hardcoded, usa il prefisso restituito da brew --prefix dopo l’installazione. È un dettaglio piccolo, ma utile se in futuro cambi architettura o se Homebrew viene installato in una posizione diversa dal default.

Verifica dell’installazione e controllo del prefisso

Una volta completata l’installazione, controlla che il binario risponda, che il prefisso sia corretto e che la shell veda il comando senza dover ricorrere a percorsi assoluti.

brew --version
brew --prefix
which brew
brew doctor

Esito atteso: brew --version mostra una versione valida, which brew punta alla directory di Homebrew, e brew doctor non segnala errori bloccanti. È normale che brew doctor riporti avvisi minori, soprattutto in ambienti server; quello che conta è distinguere i warning innocui dai problemi reali di permessi o di PATH.

Se brew non viene trovato, quasi sempre il problema è uno di questi: la shell non ha caricato il profilo corretto, il comando shellenv non è stato aggiunto nel file giusto, oppure stai usando un utente diverso da quello che ha eseguito l’installazione. In un contesto multiutente, questo è il punto in cui conviene fermarsi e capire chi deve realmente usare Homebrew.

Installare il primo pacchetto con Homebrew

Per validare il flusso, installa un pacchetto semplice e non invasivo. Un esempio comune è jq, utile per manipolare JSON da riga di comando, oppure htop per verificare l’uso interattivo dei processi. L’obiettivo non è il pacchetto in sé, ma il fatto che la catena di installazione funzioni end-to-end.

brew install jq
jq --version

Se l’installazione fallisce, osserva il messaggio esatto. I casi più comuni sono mancanza di toolchain, problemi di rete verso GitHub o repository temporaneamente non raggiungibili, oppure permessi errati sulle directory di Homebrew. Non partire subito con modifiche strutturali: prima isola il layer che sta fallendo.

Gestione delle dipendenze e aggiornamenti

Homebrew tende a funzionare bene quando lo mantieni aggiornato con regolarità. Su una macchina che resta accesa a lungo, conviene aggiornare il repository, controllare le formule installate e ripulire i pacchetti non più necessari.

brew update
brew upgrade
brew cleanup

Su un server usato anche per attività operative, è meglio evitare upgrade automatici non controllati. Se aggiorni strumenti usati in script o pipeline, verifica prima la compatibilità delle nuove versioni con i job esistenti. In altre parole: Homebrew aggiorna in fretta, ma non sempre il resto del tuo stack è pronto a seguirlo allo stesso ritmo.

Permessi, utenti e isolamento operativo

Uno dei vantaggi di Homebrew è che non richiede l’uso continuo di root. Questo riduce il blast radius delle operazioni quotidiane. Se però installi Homebrew come un utente e poi lo usi come un altro, ti ritrovi con problemi di ownership sulle directory e con binari non visibili nel profilo corretto.

Il criterio pratico è semplice: l’utente che lancia brew deve essere lo stesso che possiede la directory di installazione, salvo configurazioni intenzionalmente condivise e ben documentate. Se devi operare su un ambiente con più amministratori, definisci chi gestisce Homebrew e in quale profilo viene mantenuto.

Controlli utili:

ls -ld /home/linuxbrew/.linuxbrew
ls -ld ~/Library 2>/dev/null
brew config

Il path esatto può variare, ma il principio resta lo stesso: ownership coerente, niente scritture improvvisate da utenti diversi, e nessuna modifica globale al sistema se non serve davvero.

Problemi comuni su Amazon Linux 2023

Il primo problema tipico è la mancata risoluzione dei pacchetti di base. Se dnf install fallisce, verifica la connettività verso i repository configurati e lo stato dei mirror. Il secondo è il PATH: Homebrew è installato correttamente, ma la shell non lo carica. Il terzo riguarda la compatibilità architetturale: su istanze ARM, formule o dipendenze possono comportarsi in modo diverso rispetto a x86_64.

Un controllo rapido per capire se il problema è di rete o di shell è questo:

curl -I https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh
brew --prefix
printenv PATH

Se curl -I fallisce, il problema è prima di Homebrew. Se brew --prefix funziona ma which brew no, il problema è nel caricamento della shell. Se invece tutto sembra corretto ma una formula non si installa, guarda il log di build e verifica eventuali dipendenze native mancanti.

Disinstallazione pulita se devi tornare indietro

Se Homebrew non serve più o vuoi rimuoverlo da un host di test, il rollback è lineare: cancelli la directory di installazione e rimuovi le righe aggiunte alla configurazione della shell dell’utente. Prima di farlo, però, verifica se esistono formule installate che ti servono ancora, perché i dati e i binari gestiti da Homebrew spariranno insieme alla sua directory.

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

Dopo la rimozione, controlla che brew non sia più disponibile e che non restino riferimenti nel profilo utente:

which brew
grep -n 'brew shellenv' ~/.bashrc ~/.bash_profile 2>/dev/null

Se il comando continua a comparire, di solito è perché c’è ancora un alias, un symlink residuo o una riga rimasta in un file di inizializzazione. In quel caso il rollback non è completo finché non ripulisci anche la shell dell’utente.

Checklist operativa finale

Se vuoi una sequenza essenziale e ripetibile, la procedura corretta su Amazon Linux 2023 è questa: verifica architettura e utente, installa i prerequisiti con dnf, esegui lo script ufficiale, carica brew shellenv, valida con brew --version e prova una formula banale. È un flusso breve, ma ogni passaggio ha un suo punto di fallimento preciso, e ignorarlo porta quasi sempre a diagnosi confuse.

Se vuoi usare Homebrew in modo stabile su una macchina Amazon Linux 2023, la regola pratica è una sola: mantieni separati sistema operativo e toolchain utente. Il sistema resta gestito da dnf, Homebrew resta nel profilo operativo, e ogni modifica al PATH o ai permessi va fatta con cognizione, non per tentativi.