# Dependency installation steps for macOS

This document assumes you are starting from a fresh install of macOS.

Most recently tested 2021-12-14 with the following macOS release:

```
% sw_vers
ProductName:	macOS
ProductVersion:	12.0.1
BuildVersion:	21A559
```



## Make sure Git is installed

macOS includes git, so you should already have that. It may prompt you to set up developer tools if
you're using it for the first time.

Most recently tested 2021-04-09 with the following git release:

```
% git --version
git version 2.24.3 (Apple Git-128)
```



## Install Homebrew

Homebrew's site gives a shell command to download and install it
https://brew.sh/

To update both the installed homebrew version and its list of formulae:

```
% brew update
```

To upgrade software installed via brew:

```
$ brew upgrade <formula name>
```

Homebrew has a search page you can use to look up formula names: http://formulae.brew.sh/

Most recently tested 2021-12-14 with the following Homebrew release:

```
% brew --version
Homebrew 3.3.8
Homebrew/homebrew-core (git revision d50fec801e7; last commit 2021-12-14)
Homebrew/homebrew-cask (git revision 9e847b02f5; last commit 2021-12-14)
```



## Install Virtualbox

This one may fail on the first attempt with a prompt to allow software signed by Oracle. After doing
that, the second attempt should succeed.

```
$ brew install virtualbox
```

Most recently tested 2021-12-14 with the following Virtualbox release:

```
% VBoxManage --version
6.1.30r148432
```



## Install Vagrant

```
$ brew install vagrant
```

Most recently tested 2021-12-14 with the following Vagrant release:

```
% vagrant --version
Vagrant 2.2.19
```



## Install GnuPG 2.x (2.11.18 or greater)

```
$ brew install gnupg
```

Most recently tested 2021-12-14 with the following GnuPG release:

```
% gpg --version
gpg (GnuPG) 2.3.3
libgcrypt 1.9.4
[...]
```



## Install Python 3.x

As of this writing, python 3.9.9 is installed by default in macOS, which should work fine. You ca
optionally install the 'python' homebrew package to get a later version.

```
$ brew install python
```

Note that to run python 3.x you need to use the name `python3`; running `python` will run python
2.x.

Most recently tested 2021-12-14 with the following Python release:

```
% python3 --version
Python 3.9.9
```



# Install direnv (Optional/Recommended)

This tool sets and unsets environment variables as you change directories in a shell session,
providing a convenient facility for setting up project-specific configuration.

```
brew install direnv
```

To activate direnv when starting bash (the default shell on macOS), add the following line to the
end of `~/.profile`:

```
eval "$(direnv hook bash)"
```

direnv also supports several other shells -- zsh, fish, tcsh, and elvish as of this writing. Its
website includes instructions for enabling each of the shells it supports.

Most recently tested 2021-12-14 with the following direnv release:

```
% direnv --version
2.29.0
```