Hackers only! Note that we always recommend to run Apollo on Ubuntu. Other platforms may be not full featured and lack of testing.

1. Make sure you have installed docker-machine, docker and virtualbox.

brew install docker docker-machine
brew cask install virtualbox

1. Start a Linux based docker machine.

docker-machine create --driver virtualbox --virtualbox-memory 4096 apollo

You should allocate at least 4GB memory. But, of course, the more resources, the better. For example:

docker-machine create --driver virtualbox \
    --virtualbox-cpu-count 2 \
    --virtualbox-memory 8192 \
    apollo

Bring up the container and start to work!

bash docker/scripts/mac/dev_start.sh
bash docker/scripts/mac/dev_into.sh

The followed procedure inside the docker container is independent with your MacOS. Try build and release.

[Inside container] bash apollo.sh build
[Inside container] ...

1. Your docker machine might go down in some situations such as suspending your MacOS. You should bring it up again:

docker-machine restart apollo

1. Your docker machine is generally running behind a NAT. You can get the address with:

docker-machine ip apollo

Remember to use it to access Apollo infras such as Dreamview, while not "localhost" or "127.0.0.1".

1. Your cert to the docker machine might expire as time goes by. If you see something like:

You can attempt to regenerate them using 'docker-machine regenerate-certs [name]'.

Just follow that instruction and run

docker-machine regenerate-certs apollo