Complete the following steps before Mod 0 in order to get the tools you’ll need on your machine.
If you’d like to watch a video overview, a Turing alum who is
at least partially competent gainfully employed in the software development industry put this video together for you, which walks through most of this guide:
The above video has shortcuts to specific pieces of this guide. Click over to it and read the video description to jump to just the right sections.
Here’s what we’ll cover in this guide. Click a link to jump to that portion of the guide:
- New to Mac?
- Install Atom as your Text Editor
- Install Xcode-select
- Install Homebrew
- Install Git
- Configure Git
- Install Chrome
- Set Up Terminal Access for Atom
- Add GitHub SSH Keys
Lets get started:
1) New to Mac?
If this is your first time using a Mac instead of a PC or Linux, then watch this video about the basics of using a Mac.
2) Install Atom as your Text Editor
Install Atom. Atom is a program where we edit code - it is a text editor with many great features that makes editing code more enjoyable compared to a simple text editor. Atom is commonly used in the software development industry, and we will use it throughout your time at Turing.
3) Install Xcode-select
Xcode is a suite of development tools published by Apple. If we wanted to develop software for the Apple Ecosystem (iPhone apps, macOS apps, etc), we would use Xcode as our editor. But even though we’re not building iPhone apps, Xcode provides some system dependencies that we need.
Rather than download Xcode via the Apple Store, we can get a much smaller selection of necessary tools, called
xcode-select, via our terminal.
Open the Terminal by pressing the
Command + Space keys at the same time, which opens Spotlight, and then type
Terminal into the search. Press the enter key, and type the following into the application, but without the
$ xcode-select --install
When prompted, enter your password.
You can verify that the installation was successful by typing
xcode-select in your terminal. You should see something like this:
$ xcode-select xcode-select: error: no command option given Usage: xcode-select [options] Print or change the path to the active developer directory. This directory controls which tools are used for the Xcode command line tools (for example, xcodebuild) as well as the BSD development commands (such as cc and make). Options: -h, --help print this help message and exit . . .
A note on convention
When you see a
$ before a line, it means “enter what follows the dollar sign as a terminal command”.
Lines that don’t have a
$ are usually what is printed out as a result of the command.
. on adjacent lines means “omitted text here”. For example:
$ xcode-select Usage: xcode-select [options] Print or change the path to the active developer directory. This directory controls which tools are used for the Xcode command line tools (for example, xcodebuild) as well as the BSD development commands (such as cc and make). Options: -h, --help print this help message and exit . . .
4) Install Homebrew
Homebrew is a package management system that makes it easy to install hundreds of open source projects and compile them from source for maximum performance on your machine.
To install homebrew, open Terminal. Again, you can get to Terminal by pressing the
Command + Space keys at the same time, then typing
Terminal into the search.
Once you have Terminal open, paste this line and hit enter. (remember, skip the
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
It will ask you for your password. This is the password to log in to your account on the computer. It needs this because it installs its packages in a place that all users of this computer can access.
When it has completed the installation run brew doctor and it should tell you that everything is fine:
$ brew doctor Your system is ready to brew.
If you got a warning from Homebrew about your path, do the following:
$ echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bash_profile $ source ~/.bash_profile // Now run "brew doctor" again and the warning should be gone.
5) Install Git
Git is a Version Control System (VCS). It allows you to save work on your project, and reference previous states of a project if needed. Normally when we save something on our computer, the newer version overwrites the older version. This is problematic if we need to look back at an earlier version. Git solves this problem by providing you multiple save points. You can get the current version, and ANY previous version. Git’s philosophy: never lose anything.
To install Git, we will use Homebrew. In your Terminal, type this:
$ brew install git
You can do
git in the terminal to verify that its working:
$ git usage: git [--version] [--help] [-C <path>] [-c <name>=<value>] [--exec-path[=<path>]] [--html-path] [--man-path] [--info-path] [-p | --paginate | -P | --no-pager] [--no-replace-objects] [--bare] [--git-dir=<path>] [--work-tree=<path>] [--namespace=<name>] <command> [<args>] These are common Git commands used in various situations: start a working area (see also: git help tutorial) clone Clone a repository into a new directory init Create an empty Git repository or reinitialize an existing one . . .
6) Configure Git
We’ll want to configure git with some basic information about us.
We can tell git to configure itself using the git config command from our terminal. Additionally, we’re setting “global” configurations for git, so we’ll use the –global flag when we provide it with a new piece of configuration.
Open Terminal with Spotlight search (press the
Command + Space keys like we did previously). Type the following, substituting your own name and email:
git config --global user.name "Alan Turing" git config --global user.email firstname.lastname@example.org
You can verify that this is working:
$ git config --list credential.helper=osxkeychain user.name=Alan Turing email@example.com
If you get “stuck” in the screen showing the output of
git config --list, don’t panic! Just type
q, and you should get back to your regular terminal.
7) Install Chrome
If you’re not already using Chrome, install it from here. Chrome includes a set of developer tools that will come in handy down the road. Additionally, it is always on the cutting edge of being able to support new web technologies.
You’ve done a lot of environment setup! How about you take a break, go for a walk, drink some water.
We’ll be here when you get back. :)
8. Set Up Terminal Access for Atom
Install the shell commands for Atom. Open Atom, drop down the
Atom menu in the top left corner of your screen, and click on
Install Shell Commands. Atom should now be enabled from your command line.
To confirm that Atom is working from your command line, open a terminal with Spotlight search (
Command + Space), type
terminal and hit enter. Type
atom . in your terminal. If it is setup correctly, the atom editor will automatically open.
If you get an error, make sure you’ve selected
Install Shell Commands from the Atom menu.
If is still not working, try entering this in the command line:
ln -s /Applications/Atom.app/Contents/Resources/app/atom.sh /usr/local/bin/atom
Try opening Atom from the command line again. If it’s still not working, message one of the Turing staff, or mention this in your cohort channel. We’ll get this squared away!
Atom also offers a number of different options and packages that you can customize to your liking. This series of videos will walk you through many of them if you’d like to dive deeper.
9. Add GitHub SSH Keys
SSH keys are a more secure and convenient way of authenticating than typing in our password every time we want to interact with Github.
This is getting fairly advanced, so if you want to stop the setup instructions here, and come back later once you’re annoyed at entering your Github password regularly, that’s totally fine.
This can be a bit tricky to do, so here’s another quick walk-through, of just adding Github SSH keys:
1. Generate a new key by running:
(You should use the email associated with your GitHub account)
$ ssh-keygen -t rsa -C "firstname.lastname@example.org"
When you’re prompted to “Enter a file in which to save the key,” press Enter. This accepts the default file location, which is
When asked to enter a password, hit enter, which means “no password”.
You’ll see a confirmation message that looks like:
Your identification has been saved in id_rsa. Your public key has been saved in id_rsa.pub. The key fingerprint is: SHA256:C3AB8FF13720E8AD9047DD39466B3C8974E592C your@email_address.com The key's randomart image is: +---[RSA 2048]----+ | . = .. | |o . . o + = .. | | =.o o o o o . | |+ +o. . .. . . | |.+E . S o o..| |.. . .o . .+| | o oo .o+| | . o ==o.=| | . .+=B=o | +----[SHA256]-----+
2. Add this new key to your system by running:
$ ssh-add ~/.ssh/id_rsa
3. Copy the new public key to your clipboard:
$ pbcopy < ~/.ssh/id_rsa.pub
4. Tell GitHub about this key.
- Go to https://github.com/settings/keys
- Click the green “New SSH key” button.
- Leave the “title” section empty
- Paste the key into the “key” section with
Command + v.
- Hit the green “Add SSH key” button.
To test that our key is configured, type the following into the command line:
$ ssh -T email@example.com
If you get a prompt similar to this:
The authenticity of host 'github.com (188.8.131.52)'... can't be established. RSA key fingerprint is 00:11:22:33:44:55:66:77:88:99:aa:bb:cc:dd:ee:ff. Are you sure you want to continue connecting (yes/no)?
If everything’s working, you’ll see the the following:
Hi <your_username>! You've successfully authenticated, but GitHub does not provide shell access.
Great work! You’ve connected your terminal to your Github profile. You can now interact with Github from your terminal without entering your password all the time.
Give yourself a pat on the back.