.gemrc file specification

An updated gemrc specification is available at RubyGems Guides (under 'gem environment'). Note that /etc/gemrc applies to all users, while ~/.gemrc applies to an individual.

If the key is a gem command (for example, install:), it specifies arguments to be used with that command.

Here are the other keys that can be specified:

:sources: A YAML array of remote gem repositories to install gems from
:verbose: Verbosity of the gem command.  false, true, and :really are the levels
:update_sources: Enable/disable automatic updating of repository metadata
:backtrace: Print backtrace when RubyGems encounters an error
:gempath: The paths in which to look for gems

'Home' is a Linux/Mac term. What is refers to is the folder where a user's settings appear. You can find out where your settings directory is by doing the following:

on Unix/Linux, open a terminal and type the following command:

echo $HOME

on Windows, open a command-prompt and type the following command:

echo %USERPROFILE%

For me (in Windows 7), this is C:\Users[name]. However, looks like Ruby doesn't set up your .gemrc in that folder by default. Instead, you have to create the file. Open a text editor, copy the YAML style code you need (documentation), and save the file as .gemrc in your home directory (make sure you select all files, not '.txt').

These settings will only affect that individual user. If it's your personal computer, however, you probably don't need to change the settings for all users.


gem looks for a configuration file .gemrc in your home directory, although you can specify another file on the command-line if you wish (with the --config-file modifier).

There are three things you can specify in the configuration file:

  • command-line arguments to be used every time gem runs
  • command-line options for ’’RDoc’’ (used when generating documentation)
  • GEM_PATH settings

More at gem environment command doc.