How should I install homebrew into /usr/local subdirectory manually?
NOTE: This answer assumes that the macOS user is setup as an administrator. Please see IMPORTANT note:
IMPORTANT: do not use sudo
unless absolutely necessary as described below. The end result should be a Homebrew installation that does not need the use of sudo
ever again.
Recommended method as of June 2021:
Use sudo
to make a subdirectory such as opt
that Homebrew can be installed under, and use your own login password if needed:
sudo mkdir /usr/local/opt
and sudo sudo
only once more to take ownership of the subdirectory under the staff
group, for example:
sudo chown brodybits:staff /usr/local/opt
At this point sudo
should no longer be needed for installing or using Homebrew.
ls -al /usr/local
should now show the new subdirectory, for example:
total 0
drwxr-xr-x 5 root wheel 160 May 13 17:13 .
drwxr-xr-x@ 11 root wheel 352 Jan 1 2020 ..
-rw-r--r-- 1 root wheel 0 Oct 16 2018 .com.apple.installer.keep
drwxr-xr-x 4 root wheel 128 May 13 17:13 bak
drwxr-xr-x 2 brodybits staff 64 May 13 17:03 opt
Now use Git to clone Homebrew/brew
from GitHub into the new subdirectory, for example:
cd /usr/local/opt
git clone https://github.com/Homebrew/brew
ls -al /usr/local/opt # recommended
Optional: It is possible to rename the newly installed brew
subdirectory, if so desired. It is also optional to move the new brew
subdirectory up to the /usr/local
level (sudo
may be needed just once more for this).
Update the desired profile file ($HOME/.zprofile
or $HOME/.zshenv
in case of zsh, for example) to add the new Homebrew bin
subdirectory to the PATH
environment variable. Here is an example:
export PATH=/usr/local/opt/brew/bin:$PATH
(See also this answer.)
Restart the shell, start a new shell, or source the profile file. It is recommended to check that which brew
shows it in the right place, /usr/local/opt/brew/bin/brew
.
At this point, brew --version
should show some information (with no homebrew-core
installed at this point), for example:
Homebrew 3.1.7-36-g7c68b17
Homebrew/homebrew-core N/A
Then run brew update
to include homebrew-core
and run brew doctor
to verify proper installation. It will likely output some warning messages about the non-standard Homebrew prefix but this should be an issue for most packages.
brew --version
after brew doctor
should show homebrew-core
included, for example:
Homebrew 3.1.7-36-g7c68b17
Homebrew/homebrew-core (git revision 61cc59c956; last commit 2021-05-13)
Try installing a simple formula such as autoconf
:
brew install autoconf
autoconf --version
should now show that it is installed.
See further below for some optional followup steps.
Outdated solution from 2018 no longer tested or updated:
First make a temporary directory within /usr/local
using sudo
(enter password if requested):
sudo mkdir /usr/local/brewtmp1
Check the results of ls -l /usr/local
:
total 0
drwxr-xr-x 2 root wheel 64 Jul 2 16:16 brewtmp1
Fix the user and group ownership of the temporary directory:
sudo chown $USER:admin brewtmp1
Check the results of ls -l /usr/local
again:
total 0
drwxr-xr-x 2 brodybits admin 64 Jul 2 16:16 brewtmp1
Then within the temporary directory download and extract the contents of master
branch of Homebrew/brew on GitHub without using sudo
:
cd /usr/local/brewtmp1
curl -L https://github.com/Homebrew/brew/tarball/master | tar xz
Check the results of ls -l
within /usr/local/brewtmp1
:
total 0
drwxr-xr-x 16 brodybits admin 512 Jul 2 14:46 Homebrew-brew-cbc3184
Check the results of ls -l Homebrew-brew-*
:
total 48
-rw-r--r-- 1 brodybits admin 98 Jul 2 14:46 CHANGELOG.md
-rw-r--r-- 1 brodybits admin 3161 Jul 2 14:46 CODE_OF_CONDUCT.md
-rw-r--r-- 1 brodybits admin 720 Jul 2 14:46 CONTRIBUTING.md
-rw-r--r-- 1 brodybits admin 1334 Jul 2 14:46 LICENSE.txt
drwxr-xr-x 7 brodybits admin 224 Jul 2 14:46 Library
-rw-r--r-- 1 brodybits admin 7374 Jul 2 14:46 README.md
drwxr-xr-x 3 brodybits admin 96 Jul 2 14:46 bin
drwxr-xr-x 5 brodybits admin 160 Jul 2 14:46 completions
drwxr-xr-x 48 brodybits admin 1536 Jul 2 14:46 docs
drwxr-xr-x 5 brodybits admin 160 Jul 2 14:46 manpages
This should show the contents of Homebrew with correct user and group.
Rename Homebrew-brew-???????
to homebrew
(without using sudo
) (it should be OK to use another name, with adaptations to other steps below):
mv Homebrew-brew-??????? homebrew
and double-check the results of ls -l
:
total 0
drwxr-xr-x 16 brodybits admin 512 Jul 2 14:46 homebrew
Move the new homebrew
directory to the right place using sudo
:
sudo mv /usr/local/brewtmp1/homebrew /usr/local
Double-check the results of ls -l /usr/local
:
total 0
drwxr-xr-x 2 brodybits admin 64 Jul 2 16:20 brewtmp1
drwxr-xr-x 16 brodybits admin 512 Jul 2 14:46 homebrew
Add the following line to profile file (.profile
or .bash_profile
as appropriate) (as directed by this answer to another question):
export PATH=/usr/local/homebrew/bin:$PATH
Restart shell, start new shell, or source the profile file. Check that which brew
shows /usr/local/homebrew/bin/brew
. Check that brew --version
works (though with no homebrew-core
installed) for example:
Homebrew >=1.4.0 (shallow or no git repository)
Homebrew/homebrew-core N/A
It is recommended to do brew doctor
at this point, which will include homebrew-core
and verify proper installation. It may output a warning about non-standard Homebrew prefix but this should be an issue for most packages. Then brew --version
should show homebrew-core
included:
Homebrew >=1.4.0 (shallow or no git repository)
Homebrew/homebrew-core (git revision 2f937; last commit 2018-07-02)
Try installing a simple formula such as autoconf
:
brew install autoconf
autoconf --version
should now show that it is installed.
ls -l /usr/local/homebrew
should now look like this:
total 48
-rw-r--r-- 1 brodybits admin 98 Jul 2 16:43 CHANGELOG.md
-rw-r--r-- 1 brodybits admin 3161 Jul 2 16:43 CODE_OF_CONDUCT.md
-rw-r--r-- 1 brodybits admin 720 Jul 2 16:43 CONTRIBUTING.md
drwxr-xr-x 3 brodybits admin 96 Jul 2 16:43 Cellar
-rw-r--r-- 1 brodybits admin 1334 Jul 2 16:43 LICENSE.txt
drwxr-xr-x 8 brodybits admin 256 Jul 2 16:43 Library
-rw-r--r-- 1 brodybits admin 7374 Jul 2 16:43 README.md
drwxr-xr-x 10 brodybits admin 320 Jul 2 16:43 bin
drwxr-xr-x 5 brodybits admin 160 Jul 2 16:43 completions
drwxr-xr-x 48 brodybits admin 1536 Jul 2 16:43 docs
drwxr-xr-x 3 brodybits admin 96 Jul 2 16:43 etc
drwxr-xr-x 5 brodybits admin 160 Jul 2 16:43 manpages
drwxr-xr-x 4 brodybits admin 128 Jul 2 16:43 opt
drwxr-xr-x 8 brodybits admin 256 Jul 2 16:43 share
drwxr-xr-x 3 brodybits admin 96 Jul 2 16:42 var
It is now recommended to add some possibly missing directories and fix some directory permissions to match the results of the Homebrew install script (I wish brew doctor
would check and offer to take care of this part):
cd /usr/local/homebrew
mkdir -p include Caskroom Cellar lib opt share var
chmod g+w include Caskroom Cellar lib opt share var
And finally cleanup /usr/local/brewtmp1
(using sudo
):
sudo rm -rf /usr/local/brewtmp1
Optional followup steps:
To disable analytics (thanks to this article, must be done after installing a package):
brew analytics off
You can Homebrew/homebrew-cask-versions
to get access to alternate versions such as daily and beta versions, as they have documented:
brew tap homebrew/cask-versions
Additional reading and other resources from 2018:
- this answer to another question
- How to install Homebrew by OSX Daily (using standard script)
- 9 of the best Homebrew packages for mac by OSX Daily