Before starting: Make sure you have the necessary folders and permissions — get more information.

Links: Homepage
Dependencies: Ruby

RubyGems ships with Ruby 1.9+. There is nothing to install. For prior versions of Ruby, see package instructions to install RubyGems.


To upgrade RubyGems.

gem update --system


All gems have documentation that is generated when a gem is installed. To start the documentation web server.

gem server

To view the documentation, point your web browser to http://localhost:8808/.

Automatically Start the Documentation Server at Boot

Create a configuration file for Launchd.

nano ~/Library/LaunchAgents/org.rubygems.gem.plist

Copy and paste the following text into the aforementioned file. The path to the gem executable cannot use the rbenv shim binary because the environment in your startup script never gets set up. Pick your primary version of Ruby and use an absolute path to the gem executable. Make sure you update the path in the configuration below.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "">
<plist version="1.0">




Register with Launchd and start the server.

launchctl load ~/Library/LaunchAgents/org.rubygems.gem.plist

Deregister with Launchd.

launchctl unload ~/Library/LaunchAgents/org.rubygems.gem.plist