Set up Jekyll environment on macOS

Set Ruby, Bundler and Jekyll on macOS Silicon

This guide is for macOS Catalina and is based on the Jekyll on macOS doc and my experience.

Install dev tools

Use the XCode CLI to install dev tools. Recommended so that you can install native extensions when installing gems.

xcode-select --install

Install homebrew

Think of Homebrew as an app store for the command line. Everything you install for Jekyll will be free and open source.

/bin/bash -c "$(curl -fsSL"

Note: be sure to replace [username] with the username you use on your Mac.

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/[yourusername]/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
export SDKROOT=$(xcrun --show-sdk-path)

Install Ruby

You can see the version of Ruby pre-installed with your Mac, by typing:

ruby -v

Your system already has a Ruby installed, but its version and gems are locked in Catalina. So here we install another Ruby using Homebrew.

brew install ruby

Ruby configuration path


echo $SHELL

The result will be zsh or bash.

For zsh, type:

echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc

For bash, type:

echo 'export PATH="$HOME/.gem/ruby/X.X.0/bin:$PATH"' >> ~/.bash_profile

X.X.0 is the version of Ruby you installed with Homebrew or open /Users/[yourusername]/.gem/ruby to check out the folder version you have installed.



Quit terminal

Run terminal again and type:

ruby -v

You will see the version of Ruby has updated.

Install Jekyll and Bundler


gem install --user-install bundler jekyll
echo $SHELL

For zsh, type:

echo 'export PATH="$HOME/.gem/ruby/[ruby_latest_version_folder_name]/bin:$PATH"' >> ~/.zshrc

For bash, type:

echo 'export PATH="$HOME/.gem/ruby/[ruby_latest_version_folder_name]/bin:$PATH"' >> ~/.bash_profile


gem env

Look for the “GEM PATHS” section and make sure they all refer to your latest Ruby version folder.

Other issues

libffi or ffi_c missing

If you run into issues installing or running because of libffi or ffi_c missing, you can try these:

brew install libffi

gem install ffi --user-install
# Or
sudo gem install ffi

Could not open library ‘glib-2.0.0’

brew install vips

© 2022. All rights reserved.