Installing on a machine missing Ruby headers #1561

jayproulx opened this Issue Sep 18, 2013 · 4 comments


None yet

2 participants


I just tried to get Jekyll up and running on my designer colleagues workstation, sudo gem install jekyll complains about a missing ruby.h file.

A pre-compiled version or installer would be great for those who don't want to install Xcode to fix the problem

parkr commented Sep 18, 2013

That'd be a RubyGems issue, not a Jekyll issue, really. If there are pre-compiled versions of the gems that require native extensions, then it'd be their prerogative to release those. I can't keep up with our gem dependencies and all the different platforms anymore :(

If a VM is possible on your colleague's machine, try an Ubuntu installation and install ruby and ruby-dev from apt-get` :)

@parkr parkr closed this Sep 18, 2013

Another suggestion would be to recognize this possible workflow in the installation instructions to help users out so we don't need to google around to find out how to resolve the issue. People using Jekyll may not necessarily (or at all) be Ruby developers with a configured Ruby development machine.

There are other users out there on stackexchange running into the same problem, if there's a good way to resolve this (tried weird combinations of installing Xcode and other tools to get the headers installed and eventually gave up), a little documentation could go a long way.

parkr commented Sep 18, 2013

Sure! I will add a note to the installation page.

As a side note, compiling Ruby shouldn't be possible without these CLT so Xcode is a prereq for using your Mac for any kind of development which requires compilation.

@parkr parkr reopened this Sep 18, 2013
@parkr parkr added a commit that closed this issue Sep 18, 2013
@parkr parkr Add note about installing Xcode on the Mac in the Installation docs.
Xcode command-line tools (clang and ruby headers) are required for installing some of Jekyll's dependencies which create native extensions.

Closes #1561.
@parkr parkr closed this in 5f6af4c Sep 18, 2013


Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment