Upgrading to Sierra for Mac OS, JavaScript, and Ruby development

  • Logitech devices cannot be customized. They are working on a fix. By the time you read this, hopefully, it’s not an issue.
  • Seil does not yet support sierra. You can remap caps lock in other ways.
  • SnagIt required an update.

Development Environment Upgrade Steps

I got these tips from Marty in our ShakaCode Slack Room:

This was setting up the development environment for the first time.

  • Ensure that you have updated homebrew:
$ brew update --all
$ brew upgrade

I’ve got this alias:

update_all='sudo softwareupdate -i -a; brew update; brew upgrade --all; brew cleanup; npm install npm -g; npm update -g; sudo gem update --system; sudo gem update; upgrade_oh_my_zsh'

Make sure that you are using the os x gcc that is included with the xcode command line tools:

$ xcode-select --install


If you have installed the gcc package via homebrew, make sure to unlink it or uninstall it:

$ brew unlink gcc


$ brew uninstall gcc


The Qt framework is required for capybara-webkit.
Follow these instructions for a workaround.

WARNING: This takes a potentially long time. I’m doing the brew install of qt.

Event Machine

Eventmachine requires an updated version of openssl to build properly.

Install openssl via homebrew:

$ brew install openssl
$ brew link openssl --force

and build the gem:

$ gem install eventmachine -v -- --with-cppflags=-I/usr/local/opt/openssl/include

[optional] configure bundler to build the eventmachine gem with the homebrew openssl:

$ bundle config build.eventmachine --with-cppflags=-I/usr/local/opt/openssl/include


V8 is required for therubyracer and is usually bundled with the libv8 gem, this version is incompatible with Sierra.

To use an older stable version, first install v8-315 with homebrew:

$ brew install homebrew/versions/v8-315
$ brew link v8-315 --force

and then build the gem using the system v8:

$ gem install libv8 -v ' -- --with-system-v8'

Note, for zsh, remove the single quotes.

$ gem install libv8 -v -- --with-system-v8

[optional] configure bundler to build the libv8 gem with the homebrew v8:

$ bundle config build.libv8 --with-system-v8

Finally, run bundle install.

Additional Issues


This installation of RMagick was configured with ImageMagick 6.9.3 but ImageMagick 6.9.6-2 is in use.

the fix is:

gem uninstall rmagick && gem install rmagick
1 Like