# salt.states.rbenv

## Managing Ruby installations with rbenv.

This module is used to install and manage ruby installations with rbenv. Different versions of ruby can be installed, and uninstalled. Rbenv will be installed automatically the first time it is needed and can be updated later. This module will not automatically install packages which rbenv will need to compile the versions of ruby.

If rbenv is run as the root user then it will be installed to /usr/local/rbenv, otherwise it will be installed to the users ~/.rbenv directory. To make rbenv available in the shell you may need to add the rbenv/shims and rbenv/bin directories to the users PATH. If you are installing as root and want other users to be able to access rbenv then you will need to add RBENV_ROOT to their environment.

This is how a state configuration could look like:

    rbenv-deps:
      pkg.installed:
        - pkgs:
          - bash
          - git
          - openssl
          - gmake
          - curl

    ruby-1.9.3-p392:
      rbenv.absent:
        - require:
          - pkg: rbenv-deps

    ruby-1.9.3-p429:
      rbenv.installed:
        - default: True
        - require:
          - pkg: rbenv-deps

`salt.states.rbenv.` `absent`(name, runas=None, user=None)

  Verify that the specified ruby is not installed with rbenv. Rbenv is installed if necessary.

  name
    The version of ruby to uninstall
  runas: None

    The user to run rbenv as.

    Deprecated since version 0.17.0.

  user: None

    The user to run rbenv as.

    New in version 0.17.0.

  New in version 0.16.0.

`salt.states.rbenv.` `installed`(name, default=False, runas=None, user=None)

  Verify that the specified ruby is installed with rbenv. Rbenv is installed if necessary.

  name
    The version of ruby to install
  default : False
    Whether to make this ruby the default.
  runas: None

    The user to run rbenv as.

    Deprecated since version 0.17.0.

  user: None

    The user to run rbenv as.

    New in version 0.17.0.

  New in version 0.16.0.

Current Salt release: 0.17.1

### Table Of Contents

- salt.states.rbenv
  - Managing Ruby installations with rbenv.

#### Previous topic

salt.states.rabbitmq_vhost

#### Next topic

salt.states.rdp

### Quick search

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

### Upcoming SaltStack Events

My conferences on Lanyrd