1) Overview
This is the official Homebrew installer. It:
- Verifies you’re on macOS or Linux with supported CPU/OS conditions.
- Ensures prerequisites (notably
bash,git,curl, and on macOS the Xcode Command Line Tools). - Creates the Homebrew prefix directory tree (either
/opt/homebrewon Apple Silicon macOS,/usr/localon Intel macOS, or/home/linuxbrew/.linuxbrewon Linux), adjusting ownership/permissions as needed (often viasudo). - Downloads Homebrew by initializing a Git repository in the target directory, configuring the
originremote to GitHub, fetching tags, and checking out the latest stable tag. - Runs
brew update --force --quietafter installation. - Optionally writes
/etc/paths.d/homebrew(macOS) so Homebrew’sbinappears in PATH for new shells; otherwise it prints “next steps” commands to addeval "$(... brew shellenv ...)"to your shell startup file.
2) Step-by-step breakdown (major sections / functions)
A. Safety checks & mode selection
set -ucauses use of unset variables to error (reduces some classes of scripting mistakes).abort()prints an error and exits.- Bash requirement: aborts if not running under bash (
BASH_VERSIONcheck). - CI / interactivity logic:
- Aborts if both
INTERACTIVEandNONINTERACTIVEare set. - If stdin isn’t a TTY or
CIis set, it setsNONINTERACTIVE=1unlessINTERACTIVEis forced. - Blocks installation if
/etc/homebrew/brew.no_installexists (used by admins to centrally prevent installs).
B. OS/platform detection & install locations
- Detects OS via
uname: - macOS (
Darwin) =>HOMEBREW_ON_MACOS=1 - Linux =>
HOMEBREW_ON_LINUX=1 - Chooses fixed, “supported” install prefix:
- macOS arm64:
HOMEBREW_PREFIX=/opt/homebrewand repository is the prefix itself. - macOS x86_64:
HOMEBREW_PREFIX=/usr/local, repository is/usr/local/Homebrew. - Linux:
HOMEBREW_PREFIX=/home/linuxbrew/.linuxbrew, repository is${prefix}/Homebrew.
C. Sudo handling and helper execution wrappers
Key functions:
- have_sudo_access(): checks presence of /usr/bin/sudo and whether the user can run it. On macOS, if it can’t get sudo, it aborts (Homebrew install requires admin there).
- execute(): runs a command and aborts with the failing command if it fails.
- retry(): retries a command up to N times with exponential backoff (used for git fetch).
- execute_sudo(): runs a command with sudo when needed and possible; otherwise runs it directly. This is how it creates/chowns/chmods system directories.
Also:
- check_run_command_as_root(): aborts if you run the installer as root unless you appear to be in a container/CI environment where root is normal.
D. Prerequisite checks
- macOS:
- Architecture must be
arm64orx86_64. - Checks macOS version ranges; warns for “unsupported” new/old versions.
- May install Xcode Command Line Tools (CLT) if missing:
- For newer macOS, it uses
softwareupdate(headless) by creating a placeholder file in/tmpto trigger CLT availability. - Otherwise uses
xcode-select --install(GUI prompt) when interactive.
- For newer macOS, it uses
- Checks for unaccepted Xcode license by inspecting
xcrun clangoutput. - Linux:
- Requires
gitandcurlmeeting minimum versions (by searching PATH for a usable one). - Ruby: if a sufficiently new Ruby isn’t usable, it either:
- aborts if glibc too old for Homebrew portable Ruby, or
- sets
HOMEBREW_FORCE_VENDOR_RUBY=1to use Homebrew’s vendored portable Ruby.
E. Pre-install plan output & interactive confirmation
- Prints what will be installed (
${prefix}/bin/brew, manpage, zsh completion, etc.) and whether/etc/paths.d/homebrewwill be created. - Computes which directories:
- already exist but are not writable/searchable,
- need to be created,
- need chmod/chown/chgrp changes.
- If interactive, waits for user confirmation (
wait_for_user()).
F. Filesystem changes (create directories, set permissions)
- If prefix exists: adjusts permissions/ownership/group on various subdirectories (via
chmod,chown,chgrp) so the installing user can manage Homebrew. - If prefix doesn’t exist: creates it (macOS uses
/usr/bin/install -d -o root -g wheel -m 0755for the prefix itself; Linux uses user/group ownership). - Creates many subdirectories under the prefix (
bin,etc,share,var,Cellar,Caskroom, etc.). - Ensures
${HOMEBREW_REPOSITORY}exists and thenchown -R ${USER}:${GROUP}that repository path. - Creates cache directory and fixes permissions:
- macOS:
${HOME}/Library/Caches/Homebrew - Linux:
${HOME}/.cache/Homebrew
Touches${HOMEBREW_CACHE}/.cleaned.
G. Download/install Homebrew via Git
Inside a subshell rooted at ${HOMEBREW_REPOSITORY}:
- git init (sets default branch main).
- Sets git config for origin URL and fetch refspec.
- git fetch from origin (retries up to 5 times), including tags.
- Determines LATEST_GIT_TAG and checks out stable branch at that tag.
- If on Intel macOS (/usr/local/Homebrew repository), it symlinks ../Homebrew/bin/brew to ${prefix}/bin/brew.
Optional:
- If HOMEBREW_NO_INSTALL_FROM_API is set, it also clones/taps homebrew/core into:
- ${HOMEBREW_REPOSITORY}/Library/Taps/homebrew/homebrew-core
H. PATH integration behavior
- If macOS and prefix is not
/usr/localand/etc/paths.dexists, it may create: /etc/paths.d/homebrewcontaining${HOMEBREW_PREFIX}/bin(viasudo tee)- Otherwise, it does not automatically modify your shell rc files; it prints “Next steps” telling you exactly what to append (the
brew shellenveval line).
I. Post-install commands & messages
- Runs:
${HOMEBREW_PREFIX}/bin/brew update --force --quiet - Writes git config flags inside the Homebrew repo to mark that the analytics message has been shown:
homebrew.analyticsmessage=truehomebrew.caskanalyticsmessage=true- Prints suggested commands to add
brew shellenvto the appropriate shell startup file (.zprofile,.bash_profile,.bashrc, fish config, etc.). - On Linux, prints OS-package-manager commands to install build dependencies (does not run them).
3) What it installs / modifies
Homebrew installation locations
Depending on platform:
macOS Apple Silicon
- Installs into: /opt/homebrew
- brew ends up at: /opt/homebrew/bin/brew
- Repository is the prefix itself: /opt/homebrew (git repo)
macOS Intel
- Prefix: /usr/local
- Repository: /usr/local/Homebrew (git repo)
- Symlink created:
- /usr/local/bin/brew → ../Homebrew/bin/brew
Linux
- Prefix: /home/linuxbrew/.linuxbrew
- Repository: /home/linuxbrew/.linuxbrew/Homebrew (git repo)
- brew at: /home/linuxbrew/.linuxbrew/bin/brew (via repo layout)
Directories created under the prefix (representative set)
The script may create (list is explicit in the directories=(...) blocks), including:
- ${prefix}/bin, ${prefix}/etc, ${prefix}/include, ${prefix}/lib, ${prefix}/sbin, ${prefix}/share, ${prefix}/opt, ${prefix}/var
- ${prefix}/Cellar, ${prefix}/Caskroom, ${prefix}/Frameworks
- ${prefix}/share/man/... (man1..man8), ${prefix}/share/zsh/site-functions, ${prefix}/etc/bash_completion.d, etc.
- ${prefix}/var/homebrew, ${prefix}/var/homebrew/linked, ${prefix}/var/log
Permissions/ownership changes
- Uses
chmod u+rwx/chmod g+rwx(group-writable) on selected existing directories if they exist but aren’t writable. - Uses
chmod go-won zsh function directories to avoid zsh refusing them when group-writable. - Uses
chown/chgrpto set ownership/group on affected directories, andchown -R ${USER}:${GROUP}on${HOMEBREW_REPOSITORY}.
Cache directory
- macOS:
~/Library/Caches/Homebrew - Linux:
~/.cache/Homebrew - Touches:
${cache}/.cleaned
PATH-related file (macOS only, conditional)
- May create/overwrite:
/etc/paths.d/homebrewcontaining one line:${HOMEBREW_PREFIX}/bin - Ownership set to
root:wheel, mode made world-readable.
Shell startup files
- It does not automatically edit your shell rc/profile file in this script.
It prints commands that would append a line like: eval "$(/opt/homebrew/bin/brew shellenv)"(or appropriate prefix/shell) to the detected rc file (e.g.~/.zprofile,~/.bash_profile,~/.bashrc,~/.config/fish/config.fish).
System services
- None are installed/enabled by this script.
4) Network activity (URLs contacted)
This script’s network actions are primarily via git fetch from GitHub:
- Homebrew/brew git remote (default):
https://github.com/Homebrew/brew- homebrew-core git remote (default, only cloned/tapped if
HOMEBREW_NO_INSTALL_FROM_APIis set during install): https://github.com/Homebrew/homebrew-core
Additionally on macOS (if installing Command Line Tools):
- Uses Apple’s softwareupdate infrastructure (/usr/sbin/softwareupdate -l and -i <label>) which contacts Apple update servers.
- xcode-select --install triggers Apple’s GUI installer flow (also contacts Apple servers).
Data sent: - Standard git client traffic to those remotes (requests refs/tags; no special exfiltration behavior in the script). - Apple update queries if CLT is installed.
Notably:
- The script exports HOMEBREW_NO_ANALYTICS_THIS_RUN=1 and HOMEBREW_NO_ANALYTICS_MESSAGE_OUTPUT=1 to suppress analytics during installation.
5) Permissions & privilege escalation
Does it use sudo/root?
Yes. It expects to use sudo in typical macOS installs and in Linux installs when the target prefix is not writable by the user.
Key behaviors:
- have_sudo_access() checks and caches sudo capability.
- execute_sudo() wraps commands that may need elevation:
- creating the prefix directory (macOS uses root:wheel ownership for the prefix directory creation),
- changing ownership/group/permissions on installation directories,
- creating /etc/paths.d/homebrew (macOS),
- installing Xcode CLT via softwareupdate (macOS),
- switching CLT path with xcode-select --switch.
What does it need elevated privileges for?
- Writing under system-owned prefixes (
/opt/homebrew,/usr/local) and adjusting permissions. - Writing to
/etc/paths.d/homebrew. - Installing Apple Command Line Tools.
Root execution is rejected
check_run_command_as_root()aborts if run as root on a normal host (exceptions for containers/CI).
6) Potential concerns (security perspective)
Expected / standard but still important
curl | bashrisk: You are executing whatever is served at that URL at runtime. Even if the repository is reputable, this pattern is inherently higher risk than downloading a known hash and verifying it.- No cryptographic pinning: The script fetches the Homebrew repo via
gitover HTTPS and checks out the latest tag, but does not verify tag signatures or pinned commit hashes here. You’re trusting GitHub HTTPS + repo integrity. - Permission changes in high-impact locations: On macOS Intel it operates under
/usr/local; on Apple Silicon it operates under/opt/homebrew. It maychown/chmodexisting directories under the prefix. If you already have content there, this can alter access controls. - Group-writable directories: It may make some directories group-writable (
chmod g+rwx) to allow admin group collaboration. That’s common for Homebrew, but it increases the set of principals who can modify Homebrew-managed paths (risk depends on who is in that group). - Creates PATH entry in
/etc/paths.d: If enabled, it changes system-wide PATH behavior for new shells. That’s intended, but it’s a global config change.
Things that look not suspicious
- No evidence of data exfiltration logic, credential harvesting, persistence mechanisms, or hidden background services.
- Uses fairly defensive scripting patterns: abort-on-error wrappers, retries, environment checks, clear output of planned actions.
7) Verdict
This is a standard, widely-used installer for Homebrew with behavior consistent with installing a package manager: creating directories under a fixed prefix, adjusting permissions with sudo, downloading code from official GitHub remotes via git, and performing an initial brew update. The main risks are the inherent ones of curl | bash, trust in GitHub-delivered content without pinning/signature verification in this script, and the fact it changes ownership/permissions under /opt/homebrew or /usr/local (and possibly adds a system PATH entry). No strong red flags beyond those expected tradeoffs for this style of installer.
View raw script
#!/bin/bash
# We don't need return codes for "$(command)", only stdout is needed.
# Allow `[[ -n "$(command)" ]]`, `func "$(command)"`, pipes, etc.
# shellcheck disable=SC2312
set -u
abort() {
printf "%s\n" "$@" >&2
exit 1
}
# Fail fast with a concise message when not using bash
# Single brackets are needed here for POSIX compatibility
# shellcheck disable=SC2292
if [ -z "${BASH_VERSION:-}" ]
then
abort "Bash is required to interpret this script."
fi
# Check if script is run with force-interactive mode in CI
if [[ -n "${CI-}" && -n "${INTERACTIVE-}" ]]
then
abort "Cannot run force-interactive mode in CI."
fi
# Check if both `INTERACTIVE` and `NONINTERACTIVE` are set
# Always use single-quoted strings with `exp` expressions
# shellcheck disable=SC2016
if [[ -n "${INTERACTIVE-}" && -n "${NONINTERACTIVE-}" ]]
then
abort 'Both `$INTERACTIVE` and `$NONINTERACTIVE` are set. Please unset at least one variable and try again.'
fi
# Check if script is run in POSIX mode
if [[ -n "${POSIXLY_CORRECT+1}" ]]
then
abort 'Bash must not run in POSIX mode. Please unset POSIXLY_CORRECT and try again.'
fi
# Check for file that prevents Homebrew installation
if [[ -f "/etc/homebrew/brew.no_install" ]]
then
BREW_NO_INSTALL="$(cat "/etc/homebrew/brew.no_install" 2>/dev/null)"
if [[ -n "${BREW_NO_INSTALL}" ]]
then
abort "Homebrew cannot be installed because ${BREW_NO_INSTALL}."
else
abort "Homebrew cannot be installed because /etc/homebrew/brew.no_install exists!"
fi
fi
# string formatters
if [[ -t 1 ]]
then
tty_escape() { printf "\033[%sm" "$1"; }
else
tty_escape() { :; }
fi
tty_mkbold() { tty_escape "1;$1"; }
tty_underline="$(tty_escape "4;39")"
tty_blue="$(tty_mkbold 34)"
tty_red="$(tty_mkbold 31)"
tty_bold="$(tty_mkbold 39)"
tty_reset="$(tty_escape 0)"
shell_join() {
local arg
printf "%s" "$1"
shift
for arg in "$@"
do
printf " %s" "${arg// /\ }"
done
}
chomp() {
printf "%s" "${1/"$'\n'"/}"
}
ohai() {
printf "${tty_blue}==>${tty_bold} %s${tty_reset}\n" "$(shell_join "$@")"
}
warn() {
printf "${tty_red}Warning${tty_reset}: %s\n" "$(chomp "$1")" >&2
}
usage() {
cat <<EOS
Homebrew Installer
Usage: [NONINTERACTIVE=1] [CI=1] install.sh [options]
-h, --help Display this message.
NONINTERACTIVE Install without prompting for user input
CI Install in CI mode (e.g. do not prompt for user input)
EOS
exit "${1:-0}"
}
while [[ $# -gt 0 ]]
do
case "$1" in
-h | --help) usage ;;
*)
warn "Unrecognized option: '$1'"
usage 1
;;
esac
done
# Check if script is run non-interactively (e.g. CI)
# If it is run non-interactively we should not prompt for passwords.
# Always use single-quoted strings with `exp` expressions
# shellcheck disable=SC2016
if [[ -z "${NONINTERACTIVE-}" ]]
then
if [[ -n "${CI-}" ]]
then
warn 'Running in non-interactive mode because `$CI` is set.'
NONINTERACTIVE=1
elif [[ ! -t 0 ]]
then
if [[ -z "${INTERACTIVE-}" ]]
then
warn 'Running in non-interactive mode because `stdin` is not a TTY.'
NONINTERACTIVE=1
else
warn 'Running in interactive mode despite `stdin` not being a TTY because `$INTERACTIVE` is set.'
fi
fi
else
ohai 'Running in non-interactive mode because `$NONINTERACTIVE` is set.'
fi
# USER isn't always set so provide a fall back for the installer and subprocesses.
if [[ -z "${USER-}" ]]
then
USER="$(chomp "$(id -un)")"
export USER
fi
# First check OS.
OS="$(uname)"
if [[ "${OS}" == "Linux" ]]
then
HOMEBREW_ON_LINUX=1
elif [[ "${OS}" == "Darwin" ]]
then
HOMEBREW_ON_MACOS=1
else
abort "Homebrew is only supported on macOS and Linux."
fi
# Required installation paths. To install elsewhere (which is unsupported)
# you can untar https://github.com/Homebrew/brew/tarball/main
# anywhere you like.
if [[ -n "${HOMEBREW_ON_MACOS-}" ]]
then
UNAME_MACHINE="$(/usr/bin/uname -m)"
if [[ "${UNAME_MACHINE}" == "arm64" ]]
then
# On ARM macOS, this script installs to /opt/homebrew only
HOMEBREW_PREFIX="/opt/homebrew"
HOMEBREW_REPOSITORY="${HOMEBREW_PREFIX}"
else
# On Intel macOS, this script installs to /usr/local only
HOMEBREW_PREFIX="/usr/local"
HOMEBREW_REPOSITORY="${HOMEBREW_PREFIX}/Homebrew"
fi
HOMEBREW_CACHE="${HOME}/Library/Caches/Homebrew"
STAT_PRINTF=("/usr/bin/stat" "-f")
PERMISSION_FORMAT="%A"
CHOWN=("/usr/sbin/chown")
CHGRP=("/usr/bin/chgrp")
GROUP="admin"
TOUCH=("/usr/bin/touch")
INSTALL=("/usr/bin/install" -d -o "root" -g "wheel" -m "0755")
else
UNAME_MACHINE="$(uname -m)"
# On Linux, this script installs to /home/linuxbrew/.linuxbrew only
HOMEBREW_PREFIX="/home/linuxbrew/.linuxbrew"
HOMEBREW_REPOSITORY="${HOMEBREW_PREFIX}/Homebrew"
HOMEBREW_CACHE="${HOME}/.cache/Homebrew"
STAT_PRINTF=("/usr/bin/stat" "-c")
PERMISSION_FORMAT="%a"
CHOWN=("/bin/chown")
CHGRP=("/bin/chgrp")
GROUP="$(id -gn)"
TOUCH=("/bin/touch")
INSTALL=("/usr/bin/install" -d -o "${USER}" -g "${GROUP}" -m "0755")
fi
CHMOD=("/bin/chmod")
MKDIR=("/bin/mkdir" "-p")
HOMEBREW_BREW_DEFAULT_GIT_REMOTE="https://github.com/Homebrew/brew"
HOMEBREW_CORE_DEFAULT_GIT_REMOTE="https://github.com/Homebrew/homebrew-core"
# Use remote URLs of Homebrew repositories from environment if set.
HOMEBREW_BREW_GIT_REMOTE="${HOMEBREW_BREW_GIT_REMOTE:-"${HOMEBREW_BREW_DEFAULT_GIT_REMOTE}"}"
HOMEBREW_CORE_GIT_REMOTE="${HOMEBREW_CORE_GIT_REMOTE:-"${HOMEBREW_CORE_DEFAULT_GIT_REMOTE}"}"
# The URLs with and without the '.git' suffix are the same Git remote. Do not prompt.
if [[ "${HOMEBREW_BREW_GIT_REMOTE}" == "${HOMEBREW_BREW_DEFAULT_GIT_REMOTE}.git" ]]
then
HOMEBREW_BREW_GIT_REMOTE="${HOMEBREW_BREW_DEFAULT_GIT_REMOTE}"
fi
if [[ "${HOMEBREW_CORE_GIT_REMOTE}" == "${HOMEBREW_CORE_DEFAULT_GIT_REMOTE}.git" ]]
then
HOMEBREW_CORE_GIT_REMOTE="${HOMEBREW_CORE_DEFAULT_GIT_REMOTE}"
fi
export HOMEBREW_{BREW,CORE}_GIT_REMOTE
# TODO: bump version when new macOS is released or announced
MACOS_NEWEST_UNSUPPORTED="27.0"
# TODO: bump version when new macOS is released
MACOS_OLDEST_SUPPORTED="14.0"
# For Homebrew on Linux
REQUIRED_RUBY_VERSION=3.4 # https://github.com/Homebrew/brew/pull/19779
REQUIRED_GLIBC_VERSION=2.13 # https://docs.brew.sh/Homebrew-on-Linux#requirements
REQUIRED_CURL_VERSION=7.41.0 # HOMEBREW_MINIMUM_CURL_VERSION in brew.sh in Homebrew/brew
REQUIRED_GIT_VERSION=2.7.0 # HOMEBREW_MINIMUM_GIT_VERSION in brew.sh in Homebrew/brew
# no analytics during installation
export HOMEBREW_NO_ANALYTICS_THIS_RUN=1
export HOMEBREW_NO_ANALYTICS_MESSAGE_OUTPUT=1
unset HAVE_SUDO_ACCESS # unset this from the environment
# create paths.d file for /opt/homebrew installs
# (/usr/local/bin is already in the PATH)
if [[ -d "/etc/paths.d" && "${HOMEBREW_PREFIX}" != "/usr/local" && -x "$(command -v tee)" ]]
then
ADD_PATHS_D=1
fi
have_sudo_access() {
if [[ ! -x "/usr/bin/sudo" ]]
then
return 1
fi
local -a SUDO=("/usr/bin/sudo")
if [[ -n "${SUDO_ASKPASS-}" ]]
then
SUDO+=("-A")
elif [[ -n "${NONINTERACTIVE-}" ]]
then
SUDO+=("-n")
fi
if [[ -z "${HAVE_SUDO_ACCESS-}" ]]
then
if [[ -n "${NONINTERACTIVE-}" ]]
then
"${SUDO[@]}" -l mkdir &>/dev/null
else
"${SUDO[@]}" -v && "${SUDO[@]}" -l mkdir &>/dev/null
fi
HAVE_SUDO_ACCESS="$?"
fi
if [[ -n "${HOMEBREW_ON_MACOS-}" ]] && [[ "${HAVE_SUDO_ACCESS}" -ne 0 ]]
then
abort "Need sudo access on macOS (e.g. the user ${USER} needs to be an Administrator)!"
fi
return "${HAVE_SUDO_ACCESS}"
}
execute() {
if ! "$@"
then
abort "$(printf "Failed during: %s" "$(shell_join "$@")")"
fi
}
retry() {
local tries="$1" n="$1" pause=2
shift
if ! "$@"
then
while [[ $((--n)) -gt 0 ]]
do
warn "$(printf "Trying again in %d seconds: %s" "${pause}" "$(shell_join "$@")")"
sleep "${pause}"
((pause *= 2))
if "$@"
then
return
fi
done
abort "$(printf "Failed %d times doing: %s" "${tries}" "$(shell_join "$@")")"
fi
}
execute_sudo() {
local -a args=("$@")
if [[ "${EUID:-${UID}}" != "0" ]] && have_sudo_access
then
if [[ -n "${SUDO_ASKPASS-}" ]]
then
args=("-A" "${args[@]}")
fi
ohai "/usr/bin/sudo" "${args[@]}"
execute "/usr/bin/sudo" "${args[@]}"
else
ohai "${args[@]}"
execute "${args[@]}"
fi
}
getc() {
local save_state
save_state="$(/bin/stty -g)"
/bin/stty raw -echo
IFS='' read -r -n 1 -d '' "$@"
/bin/stty "${save_state}"
}
ring_bell() {
# Use the shell's audible bell.
if [[ -t 1 ]]
then
printf "\a"
fi
}
wait_for_user() {
local c
echo
echo "Press ${tty_bold}RETURN${tty_reset}/${tty_bold}ENTER${tty_reset} to continue or any other key to abort:"
getc c
# we test for \r and \n because some stuff does \r instead
if ! [[ "${c}" == $'\r' || "${c}" == $'\n' ]]
then
exit 1
fi
}
major_minor() {
echo "${1%%.*}.$(
x="${1#*.}"
echo "${x%%.*}"
)"
}
version_gt() {
[[ "${1%.*}" -gt "${2%.*}" ]] || [[ "${1%.*}" -eq "${2%.*}" && "${1#*.}" -gt "${2#*.}" ]]
}
version_ge() {
[[ "${1%.*}" -gt "${2%.*}" ]] || [[ "${1%.*}" -eq "${2%.*}" && "${1#*.}" -ge "${2#*.}" ]]
}
version_lt() {
[[ "${1%.*}" -lt "${2%.*}" ]] || [[ "${1%.*}" -eq "${2%.*}" && "${1#*.}" -lt "${2#*.}" ]]
}
check_run_command_as_root() {
[[ "${EUID:-${UID}}" == "0" ]] || return
# Allow Azure Pipelines/GitHub Actions/Docker/Concourse/Kubernetes to do everything as root (as it's normal there)
[[ -f /.dockerenv ]] && return
[[ -f /run/.containerenv ]] && return
[[ -f /proc/1/cgroup ]] && grep -E "azpl_job|actions_job|docker|garden|kubepods" -q /proc/1/cgroup && return
abort "Don't run this as root!"
}
should_install_command_line_tools() {
if [[ -n "${HOMEBREW_ON_LINUX-}" ]]
then
return 1
fi
if version_gt "${macos_version}" "10.13"
then
! [[ -e "/Library/Developer/CommandLineTools/usr/bin/git" ]]
else
! [[ -e "/Library/Developer/CommandLineTools/usr/bin/git" ]] ||
! [[ -e "/usr/include/iconv.h" ]]
fi
}
get_permission() {
"${STAT_PRINTF[@]}" "${PERMISSION_FORMAT}" "$1"
}
user_only_chmod() {
[[ -d "$1" ]] && [[ "$(get_permission "$1")" != 75[0145] ]]
}
exists_but_not_writable() {
[[ -e "$1" ]] && ! [[ -r "$1" && -w "$1" && -x "$1" ]]
}
get_owner() {
"${STAT_PRINTF[@]}" "%u" "$1"
}
file_not_owned() {
[[ "$(get_owner "$1")" != "$(id -u)" ]]
}
get_group() {
"${STAT_PRINTF[@]}" "%g" "$1"
}
file_not_grpowned() {
[[ " $(id -G "${USER}") " != *" $(get_group "$1") "* ]]
}
# Please sync with 'test_ruby()' in 'Library/Homebrew/utils/ruby.sh' from the Homebrew/brew repository.
test_ruby() {
if [[ ! -x "$1" ]]
then
return 1
fi
"$1" --enable-frozen-string-literal --disable=gems,did_you_mean,rubyopt -rrubygems -e \
"abort if Gem::Version.new(RUBY_VERSION) < \
Gem::Version.new('${REQUIRED_RUBY_VERSION}')" 2>/dev/null
}
test_curl() {
if [[ ! -x "$1" ]]
then
return 1
fi
if [[ "$1" == "/snap/bin/curl" ]]
then
warn "Ignoring $1 (curl snap is too restricted)"
return 1
fi
local curl_version_output curl_name_and_version
curl_version_output="$("$1" --version 2>/dev/null)"
curl_name_and_version="${curl_version_output%% (*}"
version_ge "$(major_minor "${curl_name_and_version##* }")" "$(major_minor "${REQUIRED_CURL_VERSION}")"
}
test_git() {
if [[ ! -x "$1" ]]
then
return 1
fi
local git_version_output
git_version_output="$("$1" --version 2>/dev/null)"
if [[ "${git_version_output}" =~ "git version "([^ ]*).* ]]
then
version_ge "$(major_minor "${BASH_REMATCH[1]}")" "$(major_minor "${REQUIRED_GIT_VERSION}")"
else
abort "Unexpected Git version: '${git_version_output}'!"
fi
}
# Search for the given executable in PATH (avoids a dependency on the `which` command)
which() {
# Alias to Bash built-in command `type -P`
type -P "$@"
}
# Search PATH for the specified program that satisfies Homebrew requirements
# function which is set above
# shellcheck disable=SC2230
find_tool() {
if [[ $# -ne 1 ]]
then
return 1
fi
local executable
while read -r executable
do
if [[ "${executable}" != /* ]]
then
warn "Ignoring ${executable} (relative paths don't work)"
elif "test_$1" "${executable}"
then
echo "${executable}"
break
fi
done < <(which -a "$1")
}
no_usable_ruby() {
[[ -z "$(find_tool ruby)" ]] || ! ruby -e "require 'erb'"
}
outdated_glibc() {
local glibc_version
glibc_version="$(ldd --version | head -n1 | grep -o '[0-9.]*$' | grep -o '^[0-9]\+\.[0-9]\+')"
version_lt "${glibc_version}" "${REQUIRED_GLIBC_VERSION}"
}
if [[ -n "${HOMEBREW_ON_LINUX-}" ]] && no_usable_ruby
then
if outdated_glibc
then
abort "$(
cat <<EOABORT
Homebrew requires Ruby ${REQUIRED_RUBY_VERSION} which was not found on your system.
Homebrew portable Ruby requires Glibc version ${REQUIRED_GLIBC_VERSION} or newer,
and your Glibc version is too old. See:
${tty_underline}https://docs.brew.sh/Homebrew-on-Linux#requirements${tty_reset}
Please install Ruby ${REQUIRED_RUBY_VERSION} and add its location to your PATH.
EOABORT
)"
else
export HOMEBREW_FORCE_VENDOR_RUBY=1
fi
fi
# Invalidate sudo timestamp before exiting (if it wasn't active before).
if [[ -x /usr/bin/sudo ]] && ! /usr/bin/sudo -n -v 2>/dev/null
then
trap '/usr/bin/sudo -k' EXIT
fi
# Things can fail later if `pwd` doesn't exist.
# Also sudo prints a warning message for no good reason
cd "/usr" || exit 1
####################################################################### script
# shellcheck disable=SC2016
ohai 'Checking for `sudo` access (which may request your password)...'
if [[ -n "${HOMEBREW_ON_MACOS-}" ]]
then
[[ "${EUID:-${UID}}" == "0" ]] || have_sudo_access
elif ! [[ -w "${HOMEBREW_PREFIX}" ]] &&
! [[ -w "/home/linuxbrew" ]] &&
! [[ -w "/home" ]] &&
! have_sudo_access
then
abort "$(
cat <<EOABORT
Insufficient permissions to install Homebrew to "${HOMEBREW_PREFIX}" (the default prefix).
Alternative (unsupported) installation methods are available at:
https://docs.brew.sh/Installation#alternative-installs
Please note this will require most formula to build from source, a buggy, slow and energy-inefficient experience.
We will close any issues without response for these unsupported configurations.
EOABORT
)"
fi
HOMEBREW_CORE="${HOMEBREW_REPOSITORY}/Library/Taps/homebrew/homebrew-core"
check_run_command_as_root
if [[ -d "${HOMEBREW_PREFIX}" && ! -x "${HOMEBREW_PREFIX}" ]]
then
abort "$(
cat <<EOABORT
The Homebrew prefix ${tty_underline}${HOMEBREW_PREFIX}${tty_reset} exists but is not searchable.
If this is not intentional, please restore the default permissions and
try running the installer again:
sudo chmod 775 ${HOMEBREW_PREFIX}
EOABORT
)"
fi
if [[ -n "${HOMEBREW_ON_MACOS-}" ]]
then
# On macOS, support 64-bit Intel and ARM
if [[ "${UNAME_MACHINE}" != "arm64" ]] && [[ "${UNAME_MACHINE}" != "x86_64" ]]
then
abort "Homebrew is only supported on Intel and ARM processors!"
fi
else
if [[ "${UNAME_MACHINE}" != "x86_64" ]] && [[ "${UNAME_MACHINE}" != "aarch64" ]]
then
abort "Homebrew on Linux is only supported on Intel x86_64 and ARM64 processors!"
fi
fi
if [[ -n "${HOMEBREW_ON_MACOS-}" ]]
then
macos_version="$(major_minor "$(/usr/bin/sw_vers -productVersion)")"
if version_lt "${macos_version}" "10.7"
then
abort "$(
cat <<EOABORT
Your Mac OS X version is too old. See:
${tty_underline}https://github.com/mistydemeo/tigerbrew${tty_reset}
EOABORT
)"
elif version_lt "${macos_version}" "10.11"
then
abort "Your OS X version is too old."
elif version_ge "${macos_version}" "${MACOS_NEWEST_UNSUPPORTED}" ||
version_lt "${macos_version}" "${MACOS_OLDEST_SUPPORTED}"
then
who="We"
what=""
if version_ge "${macos_version}" "${MACOS_NEWEST_UNSUPPORTED}"
then
what="pre-release version"
else
who+=" (and Apple)"
what="old version"
fi
ohai "You are using macOS ${macos_version}."
ohai "${who} do not provide support for this ${what}."
echo "$(
cat <<EOS
This installation may not succeed.
After installation, you will encounter build failures with some formulae.
Please create pull requests instead of asking for help on Homebrew\'s GitHub,
Twitter or any other official channels. You are responsible for resolving any
issues you experience while you are running this ${what}.
EOS
)
" | tr -d "\\"
fi
fi
ohai "This script will install:"
echo "${HOMEBREW_PREFIX}/bin/brew"
echo "${HOMEBREW_PREFIX}/share/doc/homebrew"
echo "${HOMEBREW_PREFIX}/share/man/man1/brew.1"
echo "${HOMEBREW_PREFIX}/share/zsh/site-functions/_brew"
echo "${HOMEBREW_PREFIX}/etc/bash_completion.d/brew"
echo "${HOMEBREW_REPOSITORY}"
if [[ -n "${ADD_PATHS_D-}" ]]
then
echo "/etc/paths.d/homebrew"
fi
# Keep relatively in sync with
# https://github.com/Homebrew/brew/blob/HEAD/Library/Homebrew/keg.rb
directories=(
bin etc include lib sbin share opt var
Frameworks
etc/bash_completion.d lib/pkgconfig
share/aclocal share/doc share/info share/locale share/man
share/man/man1 share/man/man2 share/man/man3 share/man/man4
share/man/man5 share/man/man6 share/man/man7 share/man/man8
var/log var/homebrew var/homebrew/linked
bin/brew
)
group_chmods=()
for dir in "${directories[@]}"
do
if exists_but_not_writable "${HOMEBREW_PREFIX}/${dir}"
then
group_chmods+=("${HOMEBREW_PREFIX}/${dir}")
fi
done
# zsh refuses to read from these directories if group writable
directories=(share/zsh share/zsh/site-functions)
zsh_dirs=()
for dir in "${directories[@]}"
do
zsh_dirs+=("${HOMEBREW_PREFIX}/${dir}")
done
directories=(
bin etc include lib sbin share var opt
share/zsh share/zsh/site-functions
var/homebrew var/homebrew/linked
Cellar Caskroom Frameworks
)
mkdirs=()
for dir in "${directories[@]}"
do
if ! [[ -d "${HOMEBREW_PREFIX}/${dir}" ]]
then
mkdirs+=("${HOMEBREW_PREFIX}/${dir}")
fi
done
user_chmods=()
mkdirs_user_only=()
if [[ "${#zsh_dirs[@]}" -gt 0 ]]
then
for dir in "${zsh_dirs[@]}"
do
if [[ ! -d "${dir}" ]]
then
mkdirs_user_only+=("${dir}")
elif user_only_chmod "${dir}"
then
user_chmods+=("${dir}")
fi
done
fi
chmods=()
if [[ "${#group_chmods[@]}" -gt 0 ]]
then
chmods+=("${group_chmods[@]}")
fi
if [[ "${#user_chmods[@]}" -gt 0 ]]
then
chmods+=("${user_chmods[@]}")
fi
chowns=()
chgrps=()
if [[ "${#chmods[@]}" -gt 0 ]]
then
for dir in "${chmods[@]}"
do
if file_not_owned "${dir}"
then
chowns+=("${dir}")
fi
if file_not_grpowned "${dir}"
then
chgrps+=("${dir}")
fi
done
fi
if [[ "${#group_chmods[@]}" -gt 0 ]]
then
ohai "The following existing directories will be made group writable:"
printf "%s\n" "${group_chmods[@]}"
fi
if [[ "${#user_chmods[@]}" -gt 0 ]]
then
ohai "The following existing directories will be made writable by user only:"
printf "%s\n" "${user_chmods[@]}"
fi
if [[ "${#chowns[@]}" -gt 0 ]]
then
ohai "The following existing directories will have their owner set to ${tty_underline}${USER}${tty_reset}:"
printf "%s\n" "${chowns[@]}"
fi
if [[ "${#chgrps[@]}" -gt 0 ]]
then
ohai "The following existing directories will have their group set to ${tty_underline}${GROUP}${tty_reset}:"
printf "%s\n" "${chgrps[@]}"
fi
if [[ "${#mkdirs[@]}" -gt 0 ]]
then
ohai "The following new directories will be created:"
printf "%s\n" "${mkdirs[@]}"
fi
if should_install_command_line_tools
then
ohai "The Xcode Command Line Tools will be installed."
fi
non_default_repos=""
additional_shellenv_commands=()
if [[ "${HOMEBREW_BREW_DEFAULT_GIT_REMOTE}" != "${HOMEBREW_BREW_GIT_REMOTE}" ]]
then
ohai "HOMEBREW_BREW_GIT_REMOTE is set to a non-default URL:"
echo "${tty_underline}${HOMEBREW_BREW_GIT_REMOTE}${tty_reset} will be used as the Homebrew/brew Git remote."
non_default_repos="Homebrew/brew"
additional_shellenv_commands+=("export HOMEBREW_BREW_GIT_REMOTE=\"${HOMEBREW_BREW_GIT_REMOTE}\"")
fi
if [[ "${HOMEBREW_CORE_DEFAULT_GIT_REMOTE}" != "${HOMEBREW_CORE_GIT_REMOTE}" ]]
then
ohai "HOMEBREW_CORE_GIT_REMOTE is set to a non-default URL:"
echo "${tty_underline}${HOMEBREW_CORE_GIT_REMOTE}${tty_reset} will be used as the Homebrew/homebrew-core Git remote."
non_default_repos="${non_default_repos:-}${non_default_repos:+ and }Homebrew/homebrew-core"
additional_shellenv_commands+=("export HOMEBREW_CORE_GIT_REMOTE=\"${HOMEBREW_CORE_GIT_REMOTE}\"")
fi
if [[ -n "${HOMEBREW_NO_INSTALL_FROM_API-}" ]]
then
ohai "HOMEBREW_NO_INSTALL_FROM_API is set."
echo "Homebrew/homebrew-core will be tapped during this ${tty_bold}install${tty_reset} run."
fi
if [[ -z "${NONINTERACTIVE-}" ]]
then
ring_bell
wait_for_user
fi
if [[ -d "${HOMEBREW_PREFIX}" ]]
then
if [[ "${#chmods[@]}" -gt 0 ]]
then
execute_sudo "${CHMOD[@]}" "u+rwx" "${chmods[@]}"
fi
if [[ "${#group_chmods[@]}" -gt 0 ]]
then
execute_sudo "${CHMOD[@]}" "g+rwx" "${group_chmods[@]}"
fi
if [[ "${#user_chmods[@]}" -gt 0 ]]
then
execute_sudo "${CHMOD[@]}" "go-w" "${user_chmods[@]}"
fi
if [[ "${#chowns[@]}" -gt 0 ]]
then
execute_sudo "${CHOWN[@]}" "${USER}" "${chowns[@]}"
fi
if [[ "${#chgrps[@]}" -gt 0 ]]
then
execute_sudo "${CHGRP[@]}" "${GROUP}" "${chgrps[@]}"
fi
else
execute_sudo "${INSTALL[@]}" "${HOMEBREW_PREFIX}"
fi
if [[ "${#mkdirs[@]}" -gt 0 ]]
then
execute_sudo "${MKDIR[@]}" "${mkdirs[@]}"
execute_sudo "${CHMOD[@]}" "ug=rwx" "${mkdirs[@]}"
if [[ "${#mkdirs_user_only[@]}" -gt 0 ]]
then
execute_sudo "${CHMOD[@]}" "go-w" "${mkdirs_user_only[@]}"
fi
execute_sudo "${CHOWN[@]}" "${USER}" "${mkdirs[@]}"
execute_sudo "${CHGRP[@]}" "${GROUP}" "${mkdirs[@]}"
fi
if ! [[ -d "${HOMEBREW_REPOSITORY}" ]]
then
execute_sudo "${MKDIR[@]}" "${HOMEBREW_REPOSITORY}"
fi
execute_sudo "${CHOWN[@]}" "-R" "${USER}:${GROUP}" "${HOMEBREW_REPOSITORY}"
if ! [[ -d "${HOMEBREW_CACHE}" ]]
then
execute "${MKDIR[@]}" "${HOMEBREW_CACHE}"
fi
if exists_but_not_writable "${HOMEBREW_CACHE}"
then
execute_sudo "${CHMOD[@]}" "g+rwx" "${HOMEBREW_CACHE}"
fi
if file_not_owned "${HOMEBREW_CACHE}"
then
execute_sudo "${CHOWN[@]}" "-R" "${USER}" "${HOMEBREW_CACHE}"
fi
if file_not_grpowned "${HOMEBREW_CACHE}"
then
execute_sudo "${CHGRP[@]}" "-R" "${GROUP}" "${HOMEBREW_CACHE}"
fi
if [[ -d "${HOMEBREW_CACHE}" ]]
then
execute "${TOUCH[@]}" "${HOMEBREW_CACHE}/.cleaned"
fi
if should_install_command_line_tools && version_ge "${macos_version}" "10.13"
then
ohai "Searching online for the Command Line Tools"
# This temporary file prompts the 'softwareupdate' utility to list the Command Line Tools
clt_placeholder="/tmp/.com.apple.dt.CommandLineTools.installondemand.in-progress"
execute_sudo "${TOUCH[@]}" "${clt_placeholder}"
clt_label_command="/usr/sbin/softwareupdate -l |
grep -B 1 -E 'Command Line Tools' |
awk -F'*' '/^ *\\*/ {print \$2}' |
sed -e 's/^ *Label: //' -e 's/^ *//' |
sort -V |
tail -n1"
clt_label="$(chomp "$(/bin/bash -c "${clt_label_command}")")"
if [[ -n "${clt_label}" ]]
then
ohai "Installing ${clt_label}"
execute_sudo "/usr/sbin/softwareupdate" "-i" "${clt_label}"
execute_sudo "/usr/bin/xcode-select" "--switch" "/Library/Developer/CommandLineTools"
fi
execute_sudo "/bin/rm" "-f" "${clt_placeholder}"
fi
# Headless install may have failed, so fallback to original 'xcode-select' method
if should_install_command_line_tools && test -t 0
then
ohai "Installing the Command Line Tools (expect a GUI popup):"
execute "/usr/bin/xcode-select" "--install"
echo "Press any key when the installation has completed."
getc
execute_sudo "/usr/bin/xcode-select" "--switch" "/Library/Developer/CommandLineTools"
fi
if [[ -n "${HOMEBREW_ON_MACOS-}" ]] && ! output="$(/usr/bin/xcrun clang 2>&1)" && [[ "${output}" == *"license"* ]]
then
abort "$(
cat <<EOABORT
You have not agreed to the Xcode license.
Before running the installer again please agree to the license by opening
Xcode.app or running:
sudo xcodebuild -license
EOABORT
)"
fi
USABLE_GIT=/usr/bin/git
if [[ -n "${HOMEBREW_ON_LINUX-}" ]]
then
USABLE_GIT="$(find_tool git)"
if [[ -z "$(command -v git)" ]]
then
abort "$(
cat <<EOABORT
You must install Git before installing Homebrew. See:
${tty_underline}https://docs.brew.sh/Installation${tty_reset}
EOABORT
)"
fi
if [[ -z "${USABLE_GIT}" ]]
then
abort "$(
cat <<EOABORT
The version of Git that was found does not satisfy requirements for Homebrew.
Please install Git ${REQUIRED_GIT_VERSION} or newer and add it to your PATH.
EOABORT
)"
fi
if [[ "${USABLE_GIT}" != /usr/bin/git ]]
then
export HOMEBREW_GIT_PATH="${USABLE_GIT}"
ohai "Found Git: ${HOMEBREW_GIT_PATH}"
fi
fi
if ! command -v curl >/dev/null
then
abort "$(
cat <<EOABORT
You must install cURL before installing Homebrew. See:
${tty_underline}https://docs.brew.sh/Installation${tty_reset}
EOABORT
)"
elif [[ -n "${HOMEBREW_ON_LINUX-}" ]]
then
USABLE_CURL="$(find_tool curl)"
if [[ -z "${USABLE_CURL}" ]]
then
abort "$(
cat <<EOABORT
The version of cURL that was found does not satisfy requirements for Homebrew.
Please install cURL ${REQUIRED_CURL_VERSION} or newer and add it to your PATH.
EOABORT
)"
elif [[ "${USABLE_CURL}" != /usr/bin/curl ]]
then
export HOMEBREW_CURL_PATH="${USABLE_CURL}"
ohai "Found cURL: ${HOMEBREW_CURL_PATH}"
fi
fi
ohai "Downloading and installing Homebrew..."
(
cd "${HOMEBREW_REPOSITORY}" >/dev/null || return
# we do it in four steps to avoid merge errors when reinstalling
execute "${USABLE_GIT}" "-c" "init.defaultBranch=main" "init" "--quiet"
# "git remote add" will fail if the remote is defined in the global config
execute "${USABLE_GIT}" "config" "remote.origin.url" "${HOMEBREW_BREW_GIT_REMOTE}"
execute "${USABLE_GIT}" "config" "remote.origin.fetch" "+refs/heads/*:refs/remotes/origin/*"
execute "${USABLE_GIT}" "config" "--bool" "fetch.prune" "true"
# ensure we don't munge line endings on checkout
execute "${USABLE_GIT}" "config" "--bool" "core.autocrlf" "false"
# make sure symlinks are saved as-is
execute "${USABLE_GIT}" "config" "--bool" "core.symlinks" "true"
if [[ -z "${NONINTERACTIVE-}" ]]
then
quiet_progress=("--quiet" "--progress")
else
quiet_progress=("--quiet")
fi
retry 5 "${USABLE_GIT}" "fetch" "${quiet_progress[@]}" "--force" "origin"
retry 5 "${USABLE_GIT}" "fetch" "${quiet_progress[@]}" "--force" "--tags" "origin"
execute "${USABLE_GIT}" "remote" "set-head" "origin" "--auto" >/dev/null
LATEST_GIT_TAG="$("${USABLE_GIT}" -c "column.ui=never" tag --list --sort="-version:refname" | head -n1)"
if [[ -z "${LATEST_GIT_TAG}" ]]
then
abort "Failed to query latest Homebrew/brew Git tag."
fi
execute "${USABLE_GIT}" "checkout" "--quiet" "--force" "-B" "stable" "${LATEST_GIT_TAG}"
if [[ "${HOMEBREW_REPOSITORY}" != "${HOMEBREW_PREFIX}" ]]
then
if [[ "${HOMEBREW_REPOSITORY}" == "${HOMEBREW_PREFIX}/Homebrew" ]]
then
execute "ln" "-sf" "../Homebrew/bin/brew" "${HOMEBREW_PREFIX}/bin/brew"
else
abort "The Homebrew/brew repository should be placed in the Homebrew prefix directory."
fi
fi
if [[ -n "${HOMEBREW_NO_INSTALL_FROM_API-}" && ! -d "${HOMEBREW_CORE}" ]]
then
# Always use single-quoted strings with `exp` expressions
# shellcheck disable=SC2016
ohai 'Tapping homebrew/core because `$HOMEBREW_NO_INSTALL_FROM_API` is set.'
(
execute "${MKDIR[@]}" "${HOMEBREW_CORE}"
cd "${HOMEBREW_CORE}" >/dev/null || return
execute "${USABLE_GIT}" "-c" "init.defaultBranch=main" "init" "--quiet"
execute "${USABLE_GIT}" "config" "remote.origin.url" "${HOMEBREW_CORE_GIT_REMOTE}"
execute "${USABLE_GIT}" "config" "remote.origin.fetch" "+refs/heads/*:refs/remotes/origin/*"
execute "${USABLE_GIT}" "config" "--bool" "fetch.prune" "true"
execute "${USABLE_GIT}" "config" "--bool" "core.autocrlf" "false"
execute "${USABLE_GIT}" "config" "--bool" "core.symlinks" "true"
retry 5 "${USABLE_GIT}" "fetch" "--force" "${quiet_progress[@]}" \
"origin" "refs/heads/main:refs/remotes/origin/main"
execute "${USABLE_GIT}" "remote" "set-head" "origin" "--auto" >/dev/null
execute "${USABLE_GIT}" "reset" "--hard" "origin/main"
cd "${HOMEBREW_REPOSITORY}" >/dev/null || return
) || exit 1
fi
if [[ -n "${ADD_PATHS_D-}" ]]
then
execute_sudo "${MKDIR[@]}" /etc/paths.d
echo "${HOMEBREW_PREFIX}/bin" | execute_sudo tee /etc/paths.d/homebrew
execute_sudo "${CHOWN[@]}" root:wheel /etc/paths.d/homebrew
execute_sudo "${CHMOD[@]}" "a+r" /etc/paths.d/homebrew
elif [[ ":${PATH}:" != *":${HOMEBREW_PREFIX}/bin:"* ]]
then
PATH_WARN=1
fi
execute "${HOMEBREW_PREFIX}/bin/brew" "update" "--force" "--quiet"
if [[ -n "${PATH_WARN-}" ]]
then
warn "${HOMEBREW_PREFIX}/bin is not in your PATH.
Instructions on how to configure your shell for Homebrew
can be found in the 'Next steps' section below."
fi
) || exit 1
ohai "Installation successful!"
echo
ring_bell
# Use an extra newline and bold to avoid this being missed.
ohai "Homebrew has enabled anonymous aggregate formulae and cask analytics."
echo "$(
cat <<EOS
${tty_bold}Read the analytics documentation (and how to opt-out) here:
${tty_underline}https://docs.brew.sh/Analytics${tty_reset}
No analytics data has been sent yet (nor will any be during this ${tty_bold}install${tty_reset} run).
EOS
)
"
ohai "Homebrew is run entirely by unpaid volunteers. Please consider donating:"
echo "$(
cat <<EOS
${tty_underline}https://github.com/Homebrew/brew#donations${tty_reset}
EOS
)
"
(
cd "${HOMEBREW_REPOSITORY}" >/dev/null || return
execute "${USABLE_GIT}" "config" "--replace-all" "homebrew.analyticsmessage" "true"
execute "${USABLE_GIT}" "config" "--replace-all" "homebrew.caskanalyticsmessage" "true"
) || exit 1
ohai "Next steps:"
case "${SHELL}" in
*/bash*)
shellenv_suffix=" bash"
if [[ -n "${HOMEBREW_ON_LINUX-}" ]]
then
shell_rcfile="${HOME}/.bashrc"
else
shell_rcfile="${HOME}/.bash_profile"
fi
;;
*/zsh*)
shellenv_suffix=" zsh"
if [[ -n "${HOMEBREW_ON_LINUX-}" ]]
then
shell_rcfile="${ZDOTDIR:-"${HOME}"}/.zshrc"
else
shell_rcfile="${ZDOTDIR:-"${HOME}"}/.zprofile"
fi
;;
*/fish*)
shellenv_suffix=" fish"
shell_rcfile="${HOME}/.config/fish/config.fish"
;;
*)
shellenv_suffix=""
shell_rcfile="${ENV:-"${HOME}/.profile"}"
;;
esac
if grep -qs "eval \"\$(${HOMEBREW_PREFIX}/bin/brew shellenv[^\"]*)\"" "${shell_rcfile}"
then
if ! [[ -x "$(command -v brew)" ]]
then
cat <<EOS
- Run this command in your terminal to add Homebrew to your ${tty_bold}PATH${tty_reset}:
eval "\$(${HOMEBREW_PREFIX}/bin/brew shellenv${shellenv_suffix})"
EOS
fi
else
cat <<EOS
- Run these commands in your terminal to add Homebrew to your ${tty_bold}PATH${tty_reset}:
echo >> ${shell_rcfile}
echo 'eval "\$(${HOMEBREW_PREFIX}/bin/brew shellenv${shellenv_suffix})"' >> ${shell_rcfile}
eval "\$(${HOMEBREW_PREFIX}/bin/brew shellenv${shellenv_suffix})"
EOS
fi
if [[ -n "${non_default_repos}" ]]
then
plural=""
if [[ "${#additional_shellenv_commands[@]}" -gt 1 ]]
then
plural="s"
fi
printf -- "- Run these commands in your terminal to add the non-default Git remote%s for %s:\n" "${plural}" "${non_default_repos}"
printf " echo '# Set non-default Git remote%s for %s.' >> %s\n" "${plural}" "${non_default_repos}" "${shell_rcfile}"
printf " echo '%s' >> ${shell_rcfile}\n" "${additional_shellenv_commands[@]}"
printf " %s\n" "${additional_shellenv_commands[@]}"
fi
if [[ -n "${HOMEBREW_ON_LINUX-}" ]]
then
echo "- Install Homebrew's dependencies if you have sudo access:"
if [[ -x "$(command -v apt-get)" ]]
then
echo " sudo apt-get install build-essential"
elif [[ -x "$(command -v dnf)" ]]
then
echo " sudo dnf group install development-tools"
elif [[ -x "$(command -v yum)" ]]
then
echo " sudo yum groupinstall 'Development Tools'"
elif [[ -x "$(command -v pacman)" ]]
then
echo " sudo pacman -S base-devel"
elif [[ -x "$(command -v apk)" ]]
then
echo " sudo apk add build-base"
fi
cat <<EOS
For more information, see:
${tty_underline}https://docs.brew.sh/Homebrew-on-Linux${tty_reset}
- We recommend that you install GCC:
brew install gcc
EOS
fi
cat <<EOS
- Run ${tty_bold}brew help${tty_reset} to get started
- Further documentation:
${tty_underline}https://docs.brew.sh${tty_reset}
EOS