# Ruby version managers

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/help/ruby/2026.3/llms.txt).

The most popular way to install Ruby on Linux or macOS is using a version manager, for example, RVM or rbenv. Version managers allow you to install several Ruby versions on your machine and quickly switch between them. RubyMine automatically detects interpreters installed on a local machine and maintained by the following version managers:

* [RVM](https://rvm.io)

* [rbenv](https://github.com/rbenv/rbenv) with the [rbenv-gemsets](https://github.com/jf/rbenv-gemset) plugin for gemsets

* [chruby](https://github.com/postmodern/chruby)

* [asdf](https://github.com/asdf-vm/asdf) with the [asdf-ruby](https://github.com/asdf-vm/asdf-ruby) plugin

* [Mise](https://github.com/jdx/mise)

> **Tip:**
> RubyMine also automatically detects Ruby and JRuby interpreters installed with the [Homebrew](https://brew.sh/) package manager on macOS and Linux.

You can switch between Ruby interpreters (and gemsets for RVM and rbenv) on the [Ruby Interpreters](configuring-language-interpreter.html#select_ruby_interpreter) page for existing projects, and choose the required interpreter when [creating a new project](creating-and-running-your-first-language-project.html#create_rails_app).

> **Tip:**
> RubyMine also allows you to work with version managers installed on Windows 10 through [WSL](how-to-use-wsl-development-environment-in-product.html).

## Auto-suggested Ruby interpreter/gemset

> **Tip:**
> RubyMine no longer automatically switches the [project interpreter and gemset](configuring-language-interpreter.html#select_ruby_interpreter) on the project opening.

Version managers support various types of configuration files used to switch a project's Ruby version and gemset. For example, you can set the Ruby interpreter version to 2.6.3 and the gemset to sample_rails_app in one of the following ways:

* Using the `.ruby-version` / `.ruby-gemset` files .ruby-version: ``` ruby-2.6.3 ``` .ruby-gemset: ``` sample_rails_app ```

* Using the `.versions.conf` file .versions.conf: ``` ruby=2.6.3 ruby-gemset=sample_rails_app ```

### Version requirements vs. configured interpreter

These sources serve distinct roles when determining and applying Ruby versions:

Configured Ruby interpreter
: The interpreter configured on the `Settings | Languages & Frameworks | Ruby` page is the active interpreter for the module. This is the only interpreter that takes effect in RubyMine — it runs code, resolves gems, and provides code insight.

Version manager files
: Files such as `.ruby-version`, `.ruby-gemset`, `.rvmrc`, `.rbenv-gemsets`, `.rbenv-version`, `.tool-versions`, and `.versions.conf` declare required versions. RubyMine reads these requirements to determine the required Ruby version. Version manager files take precedence over `Gemfile` or `gems.rb`.

Gemfile and gems.rb
: The `ruby` directive in a `Gemfile` or `gems.rb` file declares a required Ruby version or version constraint. Supported formats include exact versions (such as `ruby "3.3.1"`), minimum or maximum bounds (such as `ruby ">= 3.1.0"`), and pessimistic version constraints (such as `ruby "~> 3.3"`). RubyMine consults the `Gemfile` or `gems.rb` only when no version manager file specifies a version.

RubyMine shows a notification if there is a mismatch in the interpreter settings for the project's Ruby modules:

* If RubyMine detects the required Ruby version installed on your machine, it will suggest setting it as the interpreter for the current project. Click the button in the notification to switch. ![Switch Ruby version from the notification](https://resources.jetbrains.com/help/img/idea/2026.3/rm_switch_version_in_notification.png)

* For Linux/macOS only: If the required Ruby version is not found and you use rbenv, RVM, or asdf, RubyMine will suggest [installing it](set-up-a-ruby-development-environment.html#ruby) using your version manager. ![Install Ruby from the notification](https://resources.jetbrains.com/help/img/idea/2026.3/rm_install_from_notification.png)

## Remote Ruby interpreters

RubyMine allows you to use [remote Ruby interpreters](configuring-language-interpreter.html#add_remote_ruby_interpreter) maintained using version managers. In this case, you have to specify a path to the version manager executable when configuring a remote interpreter. For instance, the following table lists typical paths for Linux.

| Version manager | Executable path |
| --- | --- |
| RVM |    Single-user mode: `/home/jetbrains/.rvm/bin/rvm` (for the jetbrains user)     Multi-user mode: `/usr/local/rvm/bin/rvm`     Mixed mode: `/usr/share/rvm/bin/rvm`    |
| rbenv |    `/home/jetbrains/.rbenv/bin/rbenv` (for the jetbrains user)     `/usr/bin/rbenv`    |
| chruby |    `/usr/local/share/chruby/chruby.sh`    |
| asdf |    `/home/jetbrains/.asdf/bin/asdf` (for the jetbrains user)    |
| Mise |  `/home/jetbrains/.local/bin/mise` (for the jetbrains user)  |

## Debug Ruby interpreter detection

If you have issues with detecting local Ruby interpreters maintained by your version manager, follow the steps below to help us determine the cause of the problem:

Procedure:

1. Open RubyMine and go to `Help | Diagnostic Tools | Debug Log Settings` in the main menu.

2. In the invoked dialog, specify a logger identifier for your version manager:

* RVM: `#org.jetbrains.plugins.ruby.version.management.rvm.RvmSdkRefresher`

* rbenv: `#org.jetbrains.plugins.ruby.version.management.rbenv.RbenvSdkRefresher`

* chruby: `#org.jetbrains.plugins.ruby.version.management.chruby.ChrubySdkRefresher`

* asdf: `#org.jetbrains.plugins.ruby.version.management.asdf.AsdfSdkRefresher`

* Mise: `#org.jetbrains.plugins.ruby.version.management.mise.MiseSdkRefresher`

![Custom Debug Log Configuration dialog](https://resources.jetbrains.com/help/img/idea/2026.3/rm_version_manager_debug_detection.png)

Click OK.

3. Restart RubyMine.

4. Open a [log file](getting-help.html#report-bug) and make sure it contains entries corresponding to your version manager, for example:

```
2018-07-30 16:57:18,237 [7350]  DEBUG - management.asdf.AsdfSdkRefresher - Refreshing sdks
```

5. [Create an issue](getting-help.html#contact-support) and attach the logs.

