Improve this page

Jekyll on macOS

First, you need to install the command-line tools to be able to compile native extensions, open a terminal and run:

xcode-select --install

Set up Ruby included with the OSPermalink

Check your Ruby version meets our requirements. Jekyll requires Ruby 2.2.5 or above. If you’re running an older version you’ll need to install a more recent Ruby version via Homebrew.

ruby -v
2.3.3

Now install Jekyll and Bundler.

gem install bundler jekyll

Install a newer Ruby version via HomebrewPermalink

If you wish to install the latest version of Ruby and get faster builds, we recommend doing it via Homebrew a handy package manager for macOS.

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install ruby
ruby -v
ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-darwin17]

Install multiple Ruby versions with rbenvPermalink

Developers often use rbenv to manage multiple Ruby versions. This can be useful if you want to run the same Ruby version used by your colleagues/collaborators.

# Install rbenv and ruby-build
brew install rbenv

# Setup rbenv integration to your shell
rbenv init

# Check your install
curl -fsSL https://github.com/rbenv/rbenv-installer/raw/master/bin/rbenv-doctor | bash

Restart your terminal for changes to take effect. Now we can install the Ruby version of our choice, let’s go with Ruby 2.5.1 here:

rbenv install 2.5.1
rbenv global 2.5.1
ruby -v
ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-darwin17]

That’s it! Head over rbenv command references to learn how to use different versions of Ruby in your projects.

Problems?Permalink

Check out the troubleshooting page or ask for help on our forum.