Skip to content

Instantly share code, notes, and snippets.

@zenorocha
Forked from millermedeiros/osx_setup.md
Last active August 19, 2025 10:21
Show Gist options
  • Select an option

  • Save zenorocha/7159780 to your computer and use it in GitHub Desktop.

Select an option

Save zenorocha/7159780 to your computer and use it in GitHub Desktop.
Setup macOS Sierra (10.12)

Setup macOS

I'm in a hospital in Spain and my MacBook was stolen.

Hospital Commit

Now I bought a new one and need to configure it. I have an external hard drive that backup everything using Time Machine, but I don't want all the crap I had in the old one.

1. Run Software Update

Make sure everything is up to date.

Software Update

2. Install Xcode and its "Command Line Tools"

  1. Go to App Store and install Xcode.
  2. Open and accept the terms
  3. Then go to the terminal and install "Command Line Tools":
xcode-select --install

Notice this only works for Mac OS X Mavericks (10.9) and above. For earlier versions, continue to use the in-app download in Xcode.

3. Install Dotfiles

Visit my Dotfiles repo for instructions.

This will install some useful stuff like zsh shell and lots of plugins using oh-my-zsh. Besides that, it will also set a new theme and some useful aliases for the terminal.

4. Install Softwares

Many softwares can be installed through homebrew-cask which makes the process way simpler:

curl -L https://gist.githubusercontent.com/zenorocha/7159780/raw/9b9413ff1306d78be6447f4beddcf90e7e8b2b8a/softwares.sh | sh

What's included?

Browser
Development
Other

Unfortunately some apps aren't available through homebrew-cask, so you need to install it manually.

App Store
Manually

5. Generate SSH keys for GitHub

Visit GitHub's official guide for instructions.

From that point on you're going to be able to do some git operations with GitHub \o/

6. Set Chrome Canary as default browser

  1. Launch Safari
  2. Apple โžœ Preferences
  3. General โžœ Default Web Browser
  4. Select โ€œChrome Canaryโ€ from the drop-down menu

7. Configure Sublime Text

Visit my Sublime Text preferences repo for instructions.

There you can find the whole list of plugins, preferences and snippets.

8. Install Alfred Workflows

Visit my Alfred workflow collection repo for instructions.

9. Set NPM user

npm adduser zenorocha

10. Download IE test VMs for VirtualBox

These take a while to download, so maybe do it on a separate day as a background process.

# IE8 - XP
curl -O "https://az412801.vo.msecnd.net/vhd/IEKitV1_Final/VirtualBox/OSX/IE8_XP/IE8.XP.For.MacVirtualBox.ova"

# IE9 - Win7
curl -O "https://az412801.vo.msecnd.net/vhd/IEKitV1_Final/VirtualBox/OSX/IE9_Win7/IE9.Win7.For.MacVirtualBox.part{1.sfx,2.rar,3.rar,4.rar,5.rar}"

# IE10 - Win8
curl -O "https://az412801.vo.msecnd.net/vhd/IEKitV1_Final/VirtualBox/OSX/IE10_Win8/IE10.Win8.For.MacVirtualBox.part{1.sfx,2.rar,3.rar}"

11. Profit!

:)

#!/bin/sh
# homebrew-cask
brew tap caskroom/cask
# browser
brew cask install firefox-aurora
brew cask install google-chrome
brew cask install google-chrome-canary
brew cask install opera-next
# development
brew cask install sublime-text
brew cask install kaleidoscope
brew cask install hyper
brew cask install sourcetree
brew cask install virtualbox
# other
brew cask install 1password
brew cask install alfred
brew cask install dropbox
brew cask install divvy
brew cask install mou
brew cask install skype
brew cask install spotify
brew cask install screenflow
brew cask install webtorrent
@diessica
Copy link

Zeno, just a little correction:
In "install softwares" section, I think apps.sh should be softwares.sh, right?

Great setup, btw. =)

@iamnewton
Copy link

Just so you know, you don't have to download xCode to use xcode-select --install. Unless you need the entire IDE, the cli tools including the gcc compiler come by just running that command.

@brunocoelho
Copy link

Take a look at this:

Error: No available cask for firefox-aurora
Error: No available cask for google-chrome-canary
Error: No available cask for sublime-text-3
Error: No available cask for source-tree
Error: No available cask for u-torrent

@zenorocha
Copy link
Author

@diessica, just fixed that URL.

@zsiddiqi
Copy link

I tried it yesterday and still getting errors on firefox-aurora, google-chrome-canary and u-torrent. Could you please fix them. Thanks

@facundofarias
Copy link

Some of them have changed the name, for example: sourcetree instead of source-tree.

@dhyegocalota
Copy link

Helped me a lot. Thanks guy.

@lucasmotta
Copy link

@brunocoelho and @halisz try installing the homebrew-versions... this should enable firefox-aurora and chrome-canary

@zsiddiqi
Copy link

Thanks Lucas, the home-brew-version did the trick :) Cheers

@ajcubeta
Copy link

cool dude !

@tucq88
Copy link

tucq88 commented Oct 22, 2014

do you plan to make a version for 10.10. Some apps may changed.

@benjifisher
Copy link

According to the Cask docs you can use --appdir=/Applications to create symlinks in /Applications (default is to use ~/Applications). Isn't that easier than moving them as you recommend? (not tested by me)

@furzeface
Copy link

Cheers @zenorocha, I've just sorted out my new Mac setup workflow and picked up a few tips here ๐Ÿ˜„, thanks @lucasmotta for the heads up on homebrew-versions too! ๐Ÿ‘

@kishorevaishnav
Copy link

@zenorocha, sublime-text-3 is not working instead sublime-text3 is working, i meant in the softwares.sh the line containing brew cask install sublime-text-3.

@pcanterini
Copy link

brew tap caskroom/versions
brew cask install sublime-text3

@segevofer
Copy link

amazing work! thanks for the post :)

@z00m1n
Copy link

z00m1n commented Dec 7, 2016

mou doesn't seem to support Sierra yet:

osx-1012:~ username$ brew cask install Caskroom/cask/mou
==> Satisfying dependencies
Error: Cask mou depends on macOS release <= 10.11, but you are running release 10.12.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment