Установка

Инструкции по поддерживаемой установке Homebrew находятся на главной странице.

Скрипт устанавливает Homebrew в расположение по умолчанию, которое является поддерживаемым и оптимальным (/opt/homebrew для Apple Silicon, /usr/local для macOS с процессорами Intel и /home/linuxbrew/.linuxbrew для Linux), поэтому после первоначальной установки Homebrew вам не потребуется sudo при использовании brew install. Это расположение необходимо для использования большинства bottle (бинарных пакетов). Скрипт тщательно продуман; его можно запускать, даже если в предпочтительном расположении уже установлены программы. Кроме того, он точно сообщает, что собирается сделать, прежде чем приступить к работе. Перед началом вам потребуется подтвердить все его действия.

Установщик macOS .pkg также устанавливает Homebrew в расположение по умолчанию (/opt/homebrew для Apple Silicon и /usr/local для macOS с процессорами Intel) по тем же причинам, что указаны выше. Его можно найти в последнем выпуске Homebrew/brew на GitHub. Чтобы указать другого пользователя для установки — например, если пакет устанавливается в окне входа в систему до того, как пользователь вошёл в систему, — запишите файл списка свойств в /var/tmp/.homebrew_pkg_user.plist со значением HOMEBREW_PKG_USER. Например, defaults write /var/tmp/.homebrew_pkg_user HOMEBREW_PKG_USER penny. Файл и пользователь должны существовать до начала установки.

Требования macOS

Процессор Apple Silicon или 64-разрядный процессор Intel ¹
Установленная macOS Sonoma (14) или новее на официально поддерживаемом оборудовании²
Инструменты командной строки (CLT) для Xcode (из xcode-select --install или https://developer.apple.com/download/all/) либо Xcode ³
Для установки требуется оболочка Bourne-again (то есть bash) ⁴

Расширенная настройка

Установщик Homebrew предлагает различные параметры расширенной настройки. Большинству пользователей этот раздел можно пропустить и вместо этого следовать инструкциям на главной странице!

Зеркала удалённых репозиториев Git

Если у вас возникают проблемы с подключением к GitHub.com, для установки Homebrew и brew update можно использовать зеркала Git, задав в окружении оболочки переменные HOMEBREW_BREW_GIT_REMOTE и/или HOMEBREW_CORE_GIT_REMOTE с помощью этого скрипта:

export HOMEBREW_BREW_GIT_REMOTE="..."  # put your Git mirror of Homebrew/brew here
export HOMEBREW_CORE_GIT_REMOTE="..."  # put your Git mirror of Homebrew/homebrew-core here
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Если соответствующая переменная окружения не задана, будет использоваться удалённый репозиторий Git по умолчанию, который лучше всего подходит большинству пользователей.

Примечание: задавая эти переменные, вы предоставляете этим репозиториям тот же уровень доверия, что и самому Homebrew. Вы должны быть абсолютно уверены, что эти репозитории не будут скомпрометированы.

Клонирование tap-репозиториев по умолчанию

Можно настроить Homebrew на возврат к поведению до версии 4.0.0, клонируя tap-репозиторий Homebrew/homebrew-core во время установки. Для этого задайте переменную окружения HOMEBREW_NO_INSTALL_FROM_API следующим образом:

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

В этом случае Homebrew будет устанавливать формулы и cask из tap-репозиториев homebrew/core и homebrew/cask, используя локальные копии этих репозиториев вместо API Homebrew. Если вы не сопровождаете Homebrew и не участвуете в его разработке, вероятно, не стоит включать этот параметр глобально. При необходимости его можно легко включить и после установки.

Установка без участия пользователя

Чтобы запустить установщик Homebrew в неинтерактивном режиме, без запроса паролей (например, в сценариях автоматизации), добавьте NONINTERACTIVE=1 перед командой установки.

Альтернативные способы установки

Linux или подсистема Windows 10 для Linux

См. документацию по установке Homebrew в Linux.

Действия после установки

При установке Homebrew выводит инструкции по обновлению настроек оболочки. Если не выполнить эти инструкции, Homebrew не будет работать.

В файл настроек оболочки (конкретный файл зависит от используемой оболочки, например ~/.bashrc или ~/.zshrc) необходимо добавить следующее:

eval "$(<Homebrew prefix path>/bin/brew shellenv)"

Замените <Homebrew prefix path> на каталог, в который Homebrew установлен в вашей системе. Расположение Homebrew по умолчанию можно найти в этом ответе на часто задаваемый вопрос.

Чтобы узнать больше, запустите установщик повторно или изучите исходный код установщика и посмотрите, как он формирует рекомендуемый путь.

Другой способ настроить это для нескольких операционных систем описан в этом совете в разделе «Советы и рекомендации».

Удаление

Инструкции по удалению приведены в разделе часто задаваемых вопросов.

¹ Для поддержки 32-разрядных процессоров или PPC см. MacPorts или Tigerbrew.

² Лучше всего использовать macOS 14 (Sonoma) или новее — эти версии поддерживаются. Версии 10.15 (Catalina) — 13 (Ventura) не поддерживаются, но могут работать; версии 10.14 (Mojave) и старше не запустят Homebrew. Использование OpenCore Legacy Patcher — это конфигурация уровня 2 или уровня 3 в зависимости от поколения процессора.

³ В зависимости от формулы для установки bottle (бинарного пакета), являющегося единственной поддерживаемой конфигурацией, может потребоваться установить Xcode, CLT или и то и другое. Для загрузки Xcode в старых версиях Mac OS X может потребоваться учётная запись Apple Developer. Зарегистрируйтесь бесплатно на сайте Apple.

⁴ Однострочная команда установки с сайта brew.sh использует оболочку Bourne-again, расположенную в /bin/bash. Обратите внимание: zsh, fish, tcsh и csh работать не будут.