How to set up a MacBook

Welcome!

This document describes how to install onto your MacBook the software needed to perform the labs in this class. We have purposefully kept the number of tools to a minimum: you'll need Git to load the source code onto your MacBook, and Docker to build, test, run, and ultimately deploy Limbo.

Installing Docker

• In your browser, open the Download Docker for Mac web page and click on the "Get Docker for Mac (Stable)" box, which will download Docker.dmg.
• In a terminal window, change directory to the location where Docker.dmg was downloaded, most likely: cd ~/Downloads
• Verify the checksum of the file.
  • Securely download the checksum: curl -O https://download.docker.com/mac/stable/Docker.dmg.sha256sum
  • Verify the checksum: shasum -a 256 -c Docker.dmg.sha256sum The response should be: Docker.dmg: OK
• Open Docker.dmg by double-clicking on it or from the command line: open Docker.dmg
• Drag and drop the Docker icon onto the Applications icon.

Alternate instructions if you use Homebrew:

• $ brew cask install docker
• $ brew install docker
• $ brew install docker-compose

Starting Docker

• Double-click on the Applications icon.
• Double-click on the Docker whale icon, and answer "Open" if you see a message that says, '"Docker" is an application downloaded from the Internet. Are you sure you want to open it?'
• Click "Next" on the Docker Welcome dialog box.
• Hit "OK" on the dialog box that says "Docker needs privileged access."
• Enter your password on the next window and hit the blue button (which may or may not say "OK" or "Confirm" on it).
• Wait until the Docker watch whale lights up in the menu bar and you see the "Docker is now up and running!" message. You do not need to click the "Sign in / Create a Docker ID" button. Click the Docker watch whale in the menu bar a couple of times to clear the status window on your screen.

Installing command-line developer tools, which includes Git

• In a terminal window, run this command: git --version

If you see a banner that starts with something like this, then you're ready to go: git version 2.15.0

Otherwise, you will likely see this response: xcode-select: note: no developer tools were found at '/Applications/Xcode.app', requesting install. Choose an option in the dialog to download the command line developer tools.

You should also see a dialog box that says, 'The "Git" command requires the command line developer tools. Would you like to install the tools now?' Click the "Install" button. Then click on the license agreement "Agree" button. Then, wait for the software installation process to complete.

Try running git --version again. If not, ask for help from an instructor or another student.