diff --git a/README.md b/README.md
index b50ad3b76..844ad279c 100644
--- a/README.md
+++ b/README.md
@@ -51,31 +51,40 @@ macOS developers will need:
 
 * [command line tools] or [xcode]
 * [brew]
-* [Docker For Mac] or [Docker Machine]
-* [pyenv] with [pyenv-virtualenv]
 
 [command line tools]: https://developer.apple.com/downloads
 [xcode]: https://developer.apple.com/downloads
 [brew]: https://github.com/Homebrew/brew
-[Docker For Mac]: https://beta.docker.com/docs/mac/getting-started://beta.docker.com/docs/mac/getting-started
-[Docker Machine]: https://docs.docker.com/machine/install-machine://docs.docker.com/machine/install-machine
-[pyenv]: https://github.com/yyuu/pyenv
-[pyenv-virtualenv]: https://github.com/yyuu/pyenv-virtualenv
 
 ```
 # Download the code
 git clone git@github.com:coreos-inc/quay.git && cd quay
 
 # Install the system dependencies
-brew install libevent libmagic postgresql gpgme
+brew install libevent libmagic postgresql gpgme pyenv pyenv-virtualenv docker docker-machine
+
+# create a default virtualmachine for docker
+docker-machine create -d virtualbox default
+
+# setup brew dependencies
+# note you may want to add these to your bashrc or zshrc file
+eval "$(pyenv virtualenv-init -)"
+eval "$(pyenv init -)"
+eval $(/usr/local/bin/docker-machine env default)
 
 # Some installs don't have /usr/include, required for finding SASL header files
+# http://apple.stackexchange.com/questions/196224/unix-ln-s-command-not-permitted-in-osx-el-capitan-beta3
+# note this command might fail because of new OSx write protections here above is a link that explains
+# how to fix that
 if [ ! -e /usr/include ]; then sudo ln -s `xcrun --show-sdk-path`/usr/include /usr/include; fi
 
 # Install the Python dependencies
+pyenv install 2.7.11
 pyenv virtualenv 2.7.11 quay
 pyenv activate quay
-pip install -r requirements.txt
+
+# Some packages may fail to build with clang (which now defaults to C11).
+CFLAGS='-std=c99' pip install -r requirements.txt
 pip install -r requirements-dev.txt
 
 # Setup a local config
@@ -83,17 +92,13 @@ git clone git@github.com:coreos-inc/quay-config.git ../quay-config
 ln -s ../../quay-config/local conf/stack
 ```
 
-#### clang errors
+### Useful docs
 
-Some packages may fail to build with clang (which now defaults to C11).
+[docker](https://beta.docker.com/docs/mac/getting-started://beta.docker.com/docs/mac/getting-started)
+[docker-machine](https://docs.docker.com/machine/install-machine://docs.docker.com/machine/install-machine)
+[pyenv](https://github.com/yyuu/pyenv)
+[pyenv-virtualenv](https://github.com/yyuu/pyenv-virtualenv)
 
-They can be installed with C99 with:
-
-```
-CFLAGS='-std=c99' pip install --no-cache --no-binary :all: gevent
-CFLAGS='-std=c99' pip install --no-cache --no-binary :all: cffi
-CFLAGS='-std=c99' pip install --no-cache --no-binary :all: cryptography
-```
 
 ### Linux