# salt.modules.gem

Manage ruby gems.

`salt.modules.gem.` `install`(gems, ruby=None, runas=None, version=None, rdoc=False, ri=False)

  Installs one or several gems.

  gems
    The gems to install
  ruby : None
    If RVM is installed, the ruby version and gemset to use.
  runas : None
    The user to run gem as.
  version : None
    Specify the version to install for the gem. Doesn't play nice with multiple gems at once
  rdoc : False
    Generate RDoc documentation for the gem(s).
  ri : False
    Generate RI documentation for the gem(s).

  CLI Example:

      salt '*' gem.install vagrant

`salt.modules.gem.` `list_`(prefix='', ruby=None, runas=None)

  List locally installed gems.

  prefix :
    Only list gems when the name matches this prefix.
  ruby : None
    If RVM is installed, the ruby version and gemset to use.
  runas : None
    The user to run gem as.

  CLI Example:

      salt '*' gem.list

`salt.modules.gem.` `sources_add`(source_uri, ruby=None, runas=None)

  Add a gem source.

  source_uri
    The source URI to add.
  ruby : None
    If RVM is installed, the ruby version and gemset to use.
  runas : None
    The user to run gem as.

  CLI Example:

      salt '*' gem.sources_add http://rubygems.org/

`salt.modules.gem.` `sources_list`(ruby=None, runas=None)

  List the configured gem sources.

  ruby : None
    If RVM is installed, the ruby version and gemset to use.
  runas : None
    The user to run gem as.

  CLI Example:

      salt '*' gem.sources_list

`salt.modules.gem.` `sources_remove`(source_uri, ruby=None, runas=None)

  Remove a gem source.

  source_uri
    The source URI to remove.
  ruby : None
    If RVM is installed, the ruby version and gemset to use.
  runas : None
    The user to run gem as.

  CLI Example:

      salt '*' gem.sources_remove http://rubygems.org/

`salt.modules.gem.` `uninstall`(gems, ruby=None, runas=None)

  Uninstall one or several gems.

  gems
    The gems to uninstall.
  ruby : None
    If RVM is installed, the ruby version and gemset to use.
  runas : None
    The user to run gem as.

  CLI Example:

      salt '*' gem.uninstall vagrant

`salt.modules.gem.` `update`(gems, ruby=None, runas=None)

  Update one or several gems.

  gems
    The gems to update.
  ruby : None
    If RVM is installed, the ruby version and gemset to use.
  runas : None
    The user to run gem as.

  CLI Example:

      salt '*' gem.update vagrant

`salt.modules.gem.` `update_system`(version='', ruby=None, runas=None)

  Update rubygems.

  version : (newest)
    The version of rubygems to install.
  ruby : None
    If RVM is installed, the ruby version and gemset to use.
  runas : None
    The user to run gem as.

  CLI Example:

      salt '*' gem.update_system

Current Salt release: 0.17.1

#### Previous topic

salt.modules.freebsdservice

#### Next topic

salt.modules.gentoo_service

### Quick search

Enter search terms or a module, class or function name.

### Upcoming SaltStack Events

My conferences on Lanyrd