OSX Dependencies

Install Developer Tools

The “Developer Tools” package is needed for tools like make and git used throughout our projects.

xcode-select --install

Example XCode Dialog

Install Homebrew

Homebrew is arguably the most popular package manager for OSX. Unlike most *NIX operating systems, Darwin does not ship with a package management system. This gap is filled by Homebrew. While other package management systems exist for OSX (e.g. MacPorts), all of our instructions will assume brew is installed.

To install Homebrew, simply run the following command:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Install Docker for Mac (with Docker Compose)

Docker for Mac is a Docker Community Edition (CE) version which is completely FREE. It includes everything you need to run Docker on a Mac and installed using the standard DMG/installer process.


It is recommended to install the latest Docker CE, however at a minimum Docker CE >= 17.05 is required this was the release which introduced multistage builds, more info here.

Visit the Docker for Mac site or just go ahead and directly download the Docker.dmg

Screenshot of Docker for Mac Installation

After installing, you’ll now see a new docker icon in your task bar.

Screenshot of Task Bar Item


Docker for Mac requires OS X El Capitan 10.11 or newer macOS release running on a 2010 or newer Mac, with Intel’s hardware support for MMU virtualization.

Configure AWS Vault

Now set up your AWS credentials so you can interact with AWS on the command line.

Follow the instructions for configuring AWS Vault.