Install Jekyll on Mac OS X

Episode #14 - May 02, 2016 - 5 minutes

Resources

Subscribe to Jekyll Casts

In this installation guide we’ll be using Mac OS X 10.11 El Capitan. These instructions should work for older versions of OS X but they have not but tested.

Install Xcode from the AppStore, this around a 4GB download.

Xcode

We’ll open up the Terminal which can be found at Applications/Utilities/Terminal. In the Terminal we can run the rest of our installation commands.

Terminal

We need to install “Command Line Tools” which gives us access to commonly used tools, utilities, and compilers such as make and GCC.

xcode-select --install

Command Line Tools

After that we need to agree to Xcode’s license. Either run the command below or open up Xcode which will prompt you to agree to the license.

sudo xcodebuild -license

OS X already has Ruby already installed but it has some quirks that makes installing Jekyll tricky. Instead of using this version, we’ll install our own version of Ruby.

First we’ll install Homebrew. Homebrew helps you install packages and is a must-have for anyone programming on OS X.

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Now we can install Ruby.

brew install ruby

And now we can install Jekyll.

sudo gem install jekyll

We can test Jekyll is working by checking the version installed.

jekyll -v

Version

Resources

Subscribe to Jekyll Casts