Octopress on OS X

May 05, 2012

I have been wanting to try Octopress (opens in a new tab) for a while, so I decided to spent my Friday night setting it up.  Unfortunately, I ran into a few issues installing and getting my environment setup, and I figured I would share my setup issues with everybody else.  I started with the instructions from the Octopress website.

https://octopress.org/docs/setup/ (opens in a new tab)

As you run into issues, the solutions are listed below.

RVM and Ruby Installation

First, you will need to install RVM (opens in a new tab).  I followed the instructions I found on the Pragmatic Press article (opens in a new tab) for installing Ruby (opens in a new tab) 1.9.  You can continue on with the Rails (opens in a new tab) portion of the installation, but you don't need to for Octopress.  The only thing I would change is the version mentioned in the instructions from 1.9.3 to 1.9.2-p320, which is the version needed for Octopress.

Bundler

Once you get Ruby installed, you will also hit issues with installing bundler with rb-fsevent (opens in a new tab).  I found this bug report (opens in a new tab) that provides the solution (opens in a new tab) (mad props clippit (opens in a new tab)).  In short, you will need to run the following command before setting up Octopress:

sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/

Rake

When I ran the 'rake install' command, I got the following error:

$ rake install rake aborted! You have already activated rake 0.9.2.2, but your Gemfile requires rake 0.9.2. Using bundle exec may solve this.

There is also a bug report (opens in a new tab) for this on Octopress, but it was easy enough to fix by just updating the Gemfile.lock to point to rake 0.9.2.2 instead of 0.9.2.  I imagine there is a better way to do this with Ruby, but since this is my first foray into Ruby development.

That should resolve your issues.  Best of luck!