Como instalar e usar o Homebrew no Mac passo a passo

Início » Como instalar e usar o Homebrew no Mac passo a passo

Homebrew virou praticamente o “padrão” quando o assunto é gerenciar pacotes no macOS. Quem desenvolve software, administra sistemas ou simplesmente gosta de ter o Mac sob controle acaba esbarrando nele mais cedo ou mais tarde. Com poucos comandos no terminal, você instala, atualiza e remove ferramentas de linha de comando e até aplicativos gráficos, sem ficar caçando instaladores pela internet.

Apesar de a instalação parecer técnica à primeira vista, o processo é bem tranquilo quando você entende cada etapa. Ao longo deste guia, você vai ver o que é o Homebrew, quais são os requisitos para usá‑lo, como instalar no macOS (Intel e Apple Silicon), como verificar se tudo correu bem e, principalmente, como aproveitar o gerenciador no dia a dia para lidar com pacotes, casks e serviços em segundo plano.

O que é o Homebrew e por que ele é tão usado no macOS

Homebrew é um gerenciador de pacotes de linha de comando, gratuito e de código aberto, criado para macOS e também disponível para Linux. Em termos práticos, ele é a peça que faltava no Mac para ter algo parecido com o apt do Debian/Ubuntu ou o yum/dnf do Fedora, mas com foco total em simplicidade e integração com o ecossistema Apple.

Com ele você instala, remove e atualiza programas diretamente do terminal, sem precisar entrar em sites, baixar .dmg ou .pkg e passar por instaladores manuais. O Homebrew cuida do download, da verificação, da instalação, das dependências e até da remoção limpa quando você decide desinstalar alguma coisa.

Internamente, o Homebrew se baseia em Git e Ruby, o que torna o desenvolvimento e a colaboração mais fáceis. Cada pacote é descrito em um arquivo chamado “fórmula” (formula), que nada mais é do que um script Ruby. Isso facilita contribuições, revisão de mudanças e integração de atualizações.

Para lidar com aplicativos com interface gráfica (GUI), o Homebrew oferece uma extensão chamada Homebrew Cask. Com ela, você instala apps como Google Chrome, Spotify, Atom e muitos outros, usando o mesmo gerenciador. Em vez de arrastar ícones para a pasta Aplicativos, um simples comando basta para instalar, atualizar ou remover essas aplicações.

O Homebrew também coleta alguns dados analíticos anônimos para entender o uso da ferramenta e das fórmulas, mas você pode desativar esse envio de dados facilmente com um comando, caso prefira mais privacidade.

Pacotes e gerenciadores de pacotes: o que você está instalando de verdade

Antes de mergulhar nos comandos do Homebrew, vale entender o que são “pacotes” nesse contexto. Um pacote é um conjunto organizado de arquivos e diretórios que contém tudo o que um software precisa para ser instalado: código‑fonte, binários, bibliotecas, scripts de configuração e assim por diante.

Quando você instala um programa manualmente a partir do código‑fonte, o processo costuma ser longo e chato: descompactar arquivos, rodar scripts de configuração, compilar, instalar dependências extras e torcer para que nada falhe no meio do caminho. E qualquer erro no processo manual geralmente significa começar tudo de novo.

O gerenciador de pacotes entra justamente para automatizar esse fluxo inteiro. Em vez de você cuidar de cada etapa a mão, ele baixa o pacote certo, instala dependências, configura caminhos, registra o que foi instalado e ainda oferece comandos simples para atualizar ou remover tudo de forma controlada.

No macOS, o Homebrew preencheu uma lacuna histórica de não haver um gerenciador de pacotes padrão do sistema voltado ao usuário final. É claro que existem outras ferramentas, como npm ou yarn, mas estas são focadas em ecossistemas específicos (Node.js, por exemplo). O Brew, por outro lado, é geral: lida com utilitários do sistema, linguagens de programação, bancos de dados, ferramentas de desenvolvimento e muito mais.

Requisitos de sistema para instalar o Homebrew no Mac

Para instalar o Homebrew com segurança no macOS, é preciso cumprir alguns requisitos básicos de hardware, software e permissões. Ignorar esses pontos costuma resultar em erros de instalação ou em um Brew que não funciona corretamente depois.

De forma geral, o Homebrew armazena os arquivos de instalação em diretórios como /usr/local/bin e /usr/local/Cellar em Macs Intel. Em Macs com Apple Silicon (M1, M2, M3, M4), ele usa por padrão o caminho /opt/homebrew. A pasta que entra no seu PATH (variável que o shell usa para achar comandos) é justamente aquela que contém os executáveis principais.

Estes são os requisitos mínimos recomendados para rodar o Homebrew no macOS:

• Conexão ativa com a internet, já que o gerenciador precisa baixar scripts, fórmulas e pacotes.
• Mac rodando macOS Mojave (10.14) ou superior. Versões como 10.9 a 10.13 ainda podem funcionar, mas o suporte oficial mais seguro começa no 10.14.
• Processador Intel 64‑bits ou Apple Silicon (CPU ARM da Apple).
• Ferramentas de linha de comando do Xcode (Command Line Tools, CLT), que podem ser instaladas pela App Store junto com o Xcode completo ou via terminal com xcode-select –install.
• Um shell compatível com Bourne, como bash ou zsh, que hoje é o padrão no macOS.
• Conta de usuário com privilégios de administrador, já que a instalação precisa criar diretórios e ajustar permissões do sistema.

Um detalhe importante: se sua conta de usuário não tem senha definida (campo de senha em branco), o Homebrew não conseguirá ser instalado. O script de instalação exige a digitação da senha de administrador em determinados momentos.

Instalação rápida do Homebrew pelo terminal

A forma mais simples de instalar o Homebrew é usando o script oficial fornecido pelo próprio projeto. Todo o processo é feito pelo terminal, em apenas um comando que baixa e executa o instalador.

Você pode usar o Terminal padrão do macOS ou optar por um terminal mais moderno, como o Warp, que oferece recursos extras e até ajuda com comandos. Independentemente da escolha, a instalação se baseia no mesmo comando:

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

Esse comando usa o curl para buscar o script de instalação diretamente do repositório do Homebrew no GitHub e o executa em um shell bash. Não é obrigatório entender cada linha do script para usá‑lo, mas é importante confiar na origem (o repositório oficial) e verificar se a URL não foi alterada.

Durante a execução, o instalador mostra uma lista de diretórios e arquivos que serão criados ou modificados. Você verá também uma solicitação para digitar sua senha de usuário do macOS (a mesma usada para fazer login). Os caracteres não aparecem na tela enquanto você digita, o que é normal por motivos de segurança.

Se você ainda não tiver o Xcode Command Line Tools instalado, o script avisa que irá instalar as ferramentas de desenvolvedor. Basta pressionar Return quando for solicitado e aguardar o download e instalação, que costumam levar de um a dois minutos em conexões rápidas.

Em um Mac recente com Apple Silicon e boa internet, todo o processo leva algo em torno de um a dois minutos. Em máquinas Intel mais antigas ou em redes lentas, esse tempo pode aumentar consideravelmente.

Verificando se o Homebrew está instalado corretamente

Terminado o script de instalação, vale conferir se o comando brew está realmente disponível no seu shell. Uma checagem simples é tentar executar:

brew

Se o Homebrew não estiver acessível, você verá uma mensagem do tipo “zsh: command not found: brew”. Nesse caso, ou o Brew não foi instalado, ou o diretório onde ele está não foi adicionado ao PATH do seu shell.

Você também pode verificar a existência dos diretórios padrão de instalação:

• /usr/local/bin para Macs Intel.
• /opt/homebrew para Macs com Apple Silicon.

No caso do Apple Silicon, se o diretório /opt/homebrew não existir, é sinal de que a instalação não ocorreu ou foi interrompida. Em Macs Intel, a ausência do diretório /usr/local/bin ou de arquivos do Homebrew dentro dele pode indicar problemas.

Outra verificação importante é conferir a versão instalada:

brew –version

Você deve enxergar algo como “Homebrew 4.x.x”. Se o comando retornar erro, o PATH provavelmente não está configurado para enxergar o binário do Brew.

Por fim, use o comando de diagnóstico interno do próprio gerenciador:

brew doctor

O ideal é que apareça a mensagem “Your system is ready to brew.”. Caso surjam alertas, siga as recomendações exibidas (como instalar Git, Command Line Tools ou ajustar permissões de pastas).

Configuração do PATH e do shell em Macs Intel e Apple Silicon

O comportamento do Homebrew é um pouco diferente entre Macs Intel e Macs com Apple Silicon, principalmente por causa do diretório de instalação. Isso impacta diretamente o PATH, a variável de ambiente que o shell usa para encontrar executáveis.

Em máquinas Intel, o Brew é instalado em /usr/local/bin, caminho que já costuma estar no PATH padrão do macOS. Nesse cenário, na maioria dos casos você não precisa fazer configurações extras: basta abrir o terminal e começar a usar o comando brew.

Já em Macs mais novos com chip M1, M2, M3 ou M4, o Homebrew usa por padrão o diretório /opt/homebrew. Esse caminho não faz parte do PATH padrão, então é necessário adicionar uma configuração extra ao shell.

Durante a instalação em um Apple Silicon, o script do Homebrew normalmente sugere os próximos passos, mostrando comandos que você deve rodar para incluir o Brew no PATH. A saída típica inclui algo como:

(echo; echo ‘eval “$(/opt/homebrew/bin/brew shellenv)”‘) >> ~/.zprofile
eval “$(/opt/homebrew/bin/brew shellenv)”

O primeiro comando adiciona uma linha ao arquivo ~/.zprofile, que é carregado quando um novo shell de login zsh é iniciado. O segundo comando aplica a configuração imediatamente na sessão atual, sem precisar fechar e abrir o terminal.

É importante tomar cuidado ao copiar esses comandos. Se você trocar o operador de redirecionamento “>>” por “>”, vai sobrescrever o conteúdo inteiro do arquivo .zprofile em vez de apenas acrescentar a linha ao final, o que pode apagar outras configurações já existentes.

O comando brew shellenv é responsável por ajustar várias variáveis de ambiente críticas, como:

• HOMEBREW_PREFIX (prefixo de instalação do Brew, geralmente /opt/homebrew nos Apple Silicon).
• HOMEBREW_CELLAR e HOMEBREW_REPOSITORY.
• PATH, MANPATH e INFOPATH, incluindo os diretórios do Brew na frente dos caminhos padrão.

Se você preferir, pode abrir o arquivo ~/.zprofile com um editor de texto e inserir manualmente a linha:

eval “$(/opt/homebrew/bin/brew shellenv)”

Algumas pessoas preferem configurar tudo no arquivo ~/.zshrc em vez de ~/.zprofile. Tecnicamente funciona, mas o próprio Homebrew recomenda usar o .zprofile para evitar conflitos e garantir o carregamento adequado em sessões de login.

Com o PATH configurado, basta abrir uma nova janela ou aba do terminal e testar novamente o comando brew. Se ainda aparecer “command not found”, revise o arquivo de configuração e confirme se não houve erro de digitação ou se o arquivo certo está sendo carregado pelo shell.

Instalação manual do Homebrew: baixando e rodando o script por etapas

Além da instalação “tudo em um comando”, você também pode fazer uma instalação manual em duas etapas: primeiro baixando o script de instalação, depois verificando e executando o arquivo localmente. Essa abordagem é interessante para quem quer inspecionar o código antes de rodar.

O fluxo geral dessa instalação manual é o seguinte:

• Baixar o script de instalação do Homebrew para o seu Mac usando curl.
• Verificar a integridade e o conteúdo do script, se desejar conferir o que ele faz.
• Executar o script localmente e fornecer a senha de administrador quando solicitado.
• Conferir as verificações de requisitos de sistema e aceitar a continuidade da instalação.

Depois de iniciar o script, o instalador examina seu sistema, valida versões de macOS, CPU, presença das ferramentas de linha de comando e permissões. Em seguida, pede que você confirme a continuidade, geralmente com uma resposta do tipo [Y] para prosseguir.

Ao final, o próprio Homebrew sugere comandos para testar a instalação, como o brew doctor, e mostra se todos os pacotes internos estão atualizados. Caso haja algum problema, as instruções na tela costumam indicar o que precisa ser ajustado.

Primeiros comandos com o Homebrew: help, busca e ajustes de privacidade

Com o Homebrew instalado e configurado, o próximo passo é aprender os comandos básicos para começar a trabalhar com pacotes. Felizmente, a sintaxe é bem direta: quase tudo gira em torno do comando brew seguido de um verbo.

Uma boa porta de entrada é o próprio help interno da ferramenta. Você pode chamá‑lo com:

brew help

Esse comando lista os subcomandos mais usados, explica a função de cada um e aponta para a documentação online. Sempre que pintar dúvida sobre um comando específico, você pode complementar com as páginas de ajuda oficiais.

Para localizar um pacote específico disponível no repositório, use o comando de busca:

brew search nome-do-pacote

Substitua “nome-do-pacote” pelo termo que você quer procurar, como git, python, node ou qualquer outro software. O Homebrew retorna uma lista de fórmulas e casks que casam com o texto informado.

Caso você não queira que o Homebrew colete ou envie dados analíticos sobre o uso, é possível desativar essa coleta com um comando específico. A ferramenta respeita a configuração e para de registrar estatísticas de uso vinculadas à sua instalação.

Instalando, atualizando e removendo pacotes com o Homebrew

A rotina principal com o Homebrew gira em torno de instalar, atualizar e remover pacotes. Esses comandos são curtos e seguem uma lógica fácil de memorizar, o que torna o gerenciador muito prático para uso diário.

Para instalar um novo pacote, use a sintaxe:

brew install NomeDoPacote

Basta trocar “NomeDoPacote” pelo programa que deseja adicionar ao sistema. O Homebrew baixa o pacote, resolve dependências, compila ou extrai arquivos necessários e coloca o executável na localização correta, que já está configurada no PATH.

Se em algum momento você quiser remover um pacote, tem duas opções equivalentes de comando:

• brew remove NomeDoPacote
• brew uninstall NomeDoPacote

Ambos os comandos se encarregam de desinstalar o software e, na maioria dos casos, remover arquivos associados, ajudando a manter o sistema mais limpo e organizado. Essa é uma das vantagens do Brew em relação a instalações manuais espalhadas.

Em situações mais avançadas, pode acontecer de um pacote ter dependências compartilhadas com outros. Se você precisar remover um pacote, mas não quer que ele verifique ou remova dependências que ainda são usadas por outros programas, pode utilizar:

brew uninstall –ignore-dependencies NomeDoPacote

Para manter os pacotes atualizados, o comando padrão é:

brew upgrade NomeDoPacote

Se você omitir o nome, o Brew tenta atualizar tudo o que estiver instalado, o que pode levar algum tempo se você tiver muitos pacotes, mas ajuda a garantir que o ambiente esteja com versões mais recentes.

Quando você quiser mais detalhes sobre um pacote — versão instalada, local de instalação, dependências e outras informações — use:

brew info NomeDoPacote

Esse comando é ótimo para entender o que exatamente está no seu sistema, principalmente quando você começa a acumular muitas ferramentas diferentes.

Gerenciando casks: instalando aplicativos gráficos com o Homebrew

Além dos pacotes de linha de comando, o Homebrew também gerencia aplicativos com interface gráfica por meio do sistema de casks. Isso inclui navegadores, players de música, editores de texto, IDEs e vários outros softwares que normalmente você instalaria com arquivos .dmg.

Para instalar um aplicativo via cask, use a sintaxe:

brew install –cask NomeDaCask

Por exemplo, dá para instalar um navegador ou editor popular simplesmente informando o nome da cask correspondente. O Brew cuida de baixar o app, colocá‑lo na pasta correta (em geral, /Applications) e deixar tudo pronto para uso.

Se quiser ver todas as casks que você já instalou pelo Homebrew, basta rodar:

brew list –casks

Esse comando exibe uma lista dos aplicativos gráficos gerenciados pelo Brew, o que ajuda a ter um inventário rápido do que você adicionou ao sistema via casks.

Para remover um aplicativo instalado por cask, use:

brew uninstall –cask NomeDaCask

Assim como nos pacotes de linha de comando, o Brew cuida de tirar o app do lugar certo e limpar os rastros principais, reduzindo o acúmulo de arquivos órfãos.

As casks também podem ser atualizadas para versões novas com um comando semelhante ao dos pacotes:

brew upgrade –cask NomeDaCask

Se quiser mais detalhes sobre uma cask específica — nome completo, data de instalação, caminho, versão — use:

brew info NomeDaCask

Ter esse comando sempre à mão ajuda na hora de diagnosticar problemas, checar versões ou decidir se vale ou não remover determinado aplicativo.

Usando o Homebrew para gerenciar serviços (daemons)

Outro recurso muito útil do Homebrew é a capacidade de gerenciar serviços em segundo plano, também chamados de daemons. Isso é especialmente importante para quem trabalha com bancos de dados, servidores web ou ferramentas que precisam ficar rodando sem intervenção constante.

Para ver uma lista dos serviços gerenciados pelo Brew e seus estados atuais (rodando, parado, etc.), use:

brew services list

Esse comando mostra quais serviços estão ativos para o usuário atual ou para o root, dependendo de como você configurou anteriormente. Com a lista em mãos, fica mais fácil controlar aquilo que consome recursos em segundo plano.

Quando você quiser iniciar imediatamente um serviço, o comando é:

brew services start NomeDoServico

Já para interromper um daemon em execução, use:

brew services stop NomeDoServico

Caso precise reiniciar um serviço — o que é comum depois de alterar alguma configuração — você pode fazer tudo de uma vez com:

brew services restart NomeDoServico

Por fim, se existirem serviços que não serão mais utilizados, é possível limpá‑los da configuração com:

brew services cleanup

Esse conjunto de comandos torna o gerenciamento de serviços muito mais tranquilo do que lidar manualmente com launchd, arquivos plist e demais detalhes internos do macOS.

Listando pacotes e visualizando dependências no Homebrew

Conforme você vai usando o Homebrew, é natural acumular uma quantidade cada vez maior de pacotes. Em algum momento, você provavelmente vai querer saber exatamente o que está instalado e como as dependências se relacionam.

Para ver rapidamente a lista de todos os pacotes de linha de comando instalados, use:

brew list

Esse comando exibe os nomes dos pacotes em ordem alfabética, o que já é suficiente para ter uma visão geral do ambiente. No entanto, ele não mostra a estrutura de dependências por trás de cada item.

Se você quiser visualizar um “mapa” de dependências, incluindo o que depende de quê, pode usar:

brew deps –tree –installed

Com esse comando, o Homebrew gera uma árvore de dependências para os pacotes atualmente instalados. Essa visão é excelente para entender por que certos pacotes extras estão presentes no sistema e o que pode ser removido sem causar problemas.

Logo após a instalação inicial do Brew, esses comandos provavelmente não mostrarão muita coisa, já que você ainda não terá muitos pacotes instalados. Mas, com o tempo, passam a ser ferramentas de auditoria e limpeza importantes.

Reinstalando o Xcode Command Line Tools e resolvendo erros comuns

Um ponto que costuma gerar dúvidas é o que acontece com o Homebrew depois de uma grande atualização de macOS. Em várias situações, o processo de upgrade do sistema remove ou quebra a instalação do Xcode Command Line Tools, o que impacta diretamente o uso do Brew.

Se, após atualizar o macOS, você começar a ver erros do tipo:

xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun

isso é um forte indicativo de que as ferramentas de desenvolvedor foram removidas ou ficaram em um estado inconsistente. Sem elas, comandos como git podem deixar de funcionar, e o próprio Homebrew perde a capacidade de compilar ou baixar alguns pacotes corretamente.

Nessas situações, o brew doctor também costuma acusar problemas, com avisos como:

• Warning: Git could not be found in your PATH. You may want to install Git: brew install git
• Warning: No developer tools installed. Install the Command Line Tools: xcode-select –install

A solução costuma ser reinstalar o Command Line Tools com o comando:

xcode-select –install

Depois da reinstalação, rodar novamente o brew doctor ajuda a validar se tudo voltou ao normal. Em muitos casos, basta seguir as instruções apresentadas para deixar o sistema pronto para compilar e instalar pacotes novamente.

Desinstalando o Homebrew do macOS

Se em algum momento você decidir que não quer mais usar o Homebrew, também é possível removê‑lo por completo do sistema. O próprio projeto fornece scripts e comandos para desinstalação limpa.

Uma forma prática é usar o comando oficial de desinstalação, que baixa e executa o script responsável por remover diretórios, links simbólicos e arquivos associados ao Brew. Ao rodar esse comando, você será orientado sobre o que será apagado.

Outra alternativa é usar diretamente o script uninstall.sh do próprio repositório do Homebrew. O processo é semelhante ao da instalação manual: você baixa o script, verifica o conteúdo se julgar necessário e depois executa, confirmando a remoção quando for solicitado.

Durante a desinstalação, você pode ter que confirmar algumas ações e digitar a senha de administrador. Ao final, os diretórios principais de instalação e a maior parte dos arquivos relacionados ao gerenciador são removidos, deixando o sistema em um estado próximo ao original.

Alternativas ao Homebrew para gerenciar pacotes no Mac

Embora o Homebrew seja hoje a opção mais popular, ele não é o único gerenciador de pacotes disponível para macOS. Dependendo do seu fluxo de trabalho e das ferramentas de que você precisa, pode fazer sentido conhecer as alternativas.

Entre os gestores mais conhecidos que competem (ou complementam) o Homebrew, vale destacar três:

• MacPorts: projeto de código aberto, gratuito, criado originalmente em 2002 com o nome DarwinPorts. O objetivo é facilitar a instalação de software de código aberto no macOS. Diferentemente do Homebrew, o MacPorts procura não depender tanto de bibliotecas e ferramentas do próprio sistema operacional, o que o torna mais independente em alguns cenários.
• Fink: também é um gerenciador de pacotes que roda sobre o sistema Darwin, compatível com variantes Unix. Ele pode ser controlado via terminal, mas oferece ainda uma interface gráfica chamada Fink Commander. Além de distribuir programas, o Fink permite aplicar modificações ao código‑fonte durante o processo de instalação.
• ServBay: voltado especificamente para o macOS e muito usado como ambiente de testes alternativo. Ele facilita a integração de servidores web, bancos de dados e outras ferramentas por meio de uma interface gráfica, dispensando o uso intensivo da linha de comando. É uma opção interessante para quem prefere gerenciar serviços por uma GUI em vez de scripts.

Mesmo com essas alternativas, o Homebrew continua sendo a escolha principal de quem quer flexibilidade, grande repositório de pacotes e uma comunidade ativa. Mas saber que há outras opções ajuda a montar o ambiente ideal para cada tipo de projeto.

Depois de percorrer todas essas etapas — entender o que é o Homebrew, checar requisitos, instalar, ajustar o PATH, gerenciar pacotes, casks e serviços, lidar com atualizações do macOS e até conhecer alternativas — você tem em mãos um panorama sólido para transformar o terminal em uma ferramenta muito mais poderosa no seu Mac. Usando o Brew de forma consistente, fica mais simples manter o ambiente de desenvolvimento organizado, reproduzível em novas máquinas e sempre atualizado, sem depender de instalações manuais ou de procedimentos confusos toda vez que surgir um novo projeto.