Skip to content

Latest commit

 

History

History
155 lines (98 loc) · 2.93 KB

File metadata and controls

155 lines (98 loc) · 2.93 KB

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