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

We strongly recommend that you install Ruby gems in your home directory to avoid file permissions problems and using sudo.

You can do this with the --user-install option, for instance by running:

gem install --user-install bundler jekyll

Or you can change the default gem path, by adding those lines to your shell config file, .e.g. ~/.bash_profile or ~/.bashrc if your shell is bash:

export GEM_HOME=$HOME/gems
export PATH=$HOME/gems/bin:$PATH

Relaunch your terminal and run gem env to check that default gem paths point to you home directory by default.

Set up Ruby included with the OS

Jekyll requires Ruby > 2.2.5 — we recommend that you run Ruby > 2.3 though, as more and more dependencies ask for that requirement. You’re good to go on macOS Mojave 10.14:

sw_vers -productVersion

ruby -v
ruby 2.3.7p456 (2018-03-28 revision 63024) [universal.x86_64-darwin18]

Install Bundler and Jekyll by running:

gem install bundler jekyll

Install latest stable Ruby with Homebrew

To run latest Ruby version you need to install it through Homebrew.

# Install Homebrew
/usr/bin/ruby -e "$(curl -fsSL"

brew install ruby

Don’t forget to add the brew ruby path to your shell config :

export PATH=/usr/local/opt/ruby/bin:$PATH

Then relaunch your terminal and check your updated Ruby setup:

which ruby

ruby -v
ruby 2.5.3p105 (2018-10-18 revision 65156) [x86_64-darwin18]

Yay, we are now running current stable Ruby!

We can install bundler and jekyll:

gem install bundler jekyll

That’s it, you’re ready to roll!

Manage multiple Ruby environments with rbenv

People often use rbenv to manage multiple Ruby versions. This is very useful when you need to be able to run a given Ruby version on a project.

# Install Homebrew
/usr/bin/ruby -e "$(curl -fsSL"

# Install rbenv and ruby-build
brew install rbenv

# Setup rbenv integration to your shell
rbenv init

# Check your install
curl -fsSL | bash

Restart your terminal for changes to take effect. Now you can install the Ruby version of our choice, let’s go with current latest stable Ruby:

rbenv install 2.5.3
rbenv global 2.5.3
ruby -v
ruby 2.5.3p105 (2018-10-18 revision 65156) [x86_64-darwin18]

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


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