How to get Docker, amazee.io & ZSH running on a new Mac : Quick setup guide

Chandeep Khosa
Jul 24, 2017 · 2 min read

I just bought a new Mac and decided I would install everything from scratch, no migration just a nice clean machine with only what I really needed on it.

I’ve been an amazee.io customer since July last year so am very familiar with it.

I read through the docs which although are great for newbies, I realised there were a lot of things that I already knew. I essentially wanted a bunch of commands to paste in.

So created a quick setup guide for myself, initially to help troubleshoot any potential issues that may have arisen from my setup.

  • Install ZSH : sh -c "$(curl -fsSL https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh
  • Generate a SSH key, and paste it to the amazee.io team in your private team slack channel: ssh-keygen -t rsa -b 4096 -C "chandeep@imaginecreativity.co.uk" then copy it to clipboard ready for pastingpbcopy <~/.ssh/id_rsa.pub
  • Install Homebrew : /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  • Install Docker & Docker Machine : brew install docker docker-machine
  • Install Amazeeio Cachalot : brew tap amazeeio/cachalot then brew install cachalot
  • Install latest version of Virtual Box, then install Virtual Box extension pack : https://www.virtualbox.org/wiki/Downloads
  • Create cachalot virtual box : cachalot create --provider virtualbox
  • Add environment variables to ZSH : echo "eval \$(cachalot env)" >> ~/.zshrc
  • Install Docker compose : brew install docker-compose

Importing an existing site already setup with Amazee.io

  • Git clone your repository
  • amazeeio-cachalot up
  • docker-compose up -d
  • docker-compose exec --user drupal drupal bash
  • drush status
  • Pull latest database from master locally : dsql @master
  • Pull latest files from master locally : dfiles @master

Chandeep Khosa

Written by

Freelance #Drupal 8 & Front End Developer | #Drupal8 Core contributor | Organiser @DrupalWLondon

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade