Install Jekyll

Walk through the process of getting Jekyll set up and running on your Mac.

  1. Video or tutorial

    You can watch the video(s) or follow along with the written tutorial—or both—they convey exactly the same information.

1 Open Terminal

On MacOS it isn’t too difficult to install Jekyll, but it does require everything to be completed from within Terminal.

So first: open “Terminal” on your computer. It’s in Applications > Utilities or you can search with “Spotlight”.

Yours will look different: I have mine super customized.

  1. Older MacOS

    If you have an older version of Mac OS X, specifically 10.8 and below, ☛ See the Older Mac OS X installation guide.

2 Install Homebrew

Homebrew is a package manager for Mac & Terminal—it’s like an app store, but specifically in the terminal and mostly for developer tools.

First go to the Homebrew website.

On the page, you’ll see a chunk of code—copy it.

Paste it into your Terminal and hit return, your computer will go off an install Homebrew.

It will prompt you for your computer’s password. As you type it in you won’t see anything—but it is being entered. When you’ve finished typing your password, hit Return.

3 Install Ruby with Homebrew

First we need to install the programming language Jekyll is written in: Ruby.

Using brew we can install the most recent version of Ruby.

brew install ruby

4 Install Jekyll with Ruby Gems

Next up we need to install Jekyll using Ruby’s package manager, gem:

gem install jekyll

This will go and download a whole bunch of stuff to your computer, when it’s done, you have Jekyll.

5 Check Jekyll is installed

Just to confirm that Jekyll is installed we’ll see what version we have.

If we get a version number—doesn’t matter what number—it’s installed. If we get an error message or nothing, then we have a problem.

jekyll -v

As long as you get a version number it doesn’t need to match the one in the screenshot above—it’ll probably be a newer version.