Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

rbenv

rbenv.org

  • Free plan
  • macOS
  • Linux
7.1 Club score Visit rbenv.org

What rbenv is

rbenv is free, open-source software for selecting Ruby versions on Linux and macOS. It can set a version globally, per project, or only for the current shell, and it reads a project’s `.ruby-version` file when you move between directories. Command shims route Ruby executables to the selected version. Plugins can hook into or override much of the default behavior. Installing Ruby versions is handled by the separate ruby-build plugin, whose definitions cover CRuby, JRuby, mruby, picoruby, and TruffleRuby. Installation options include Homebrew, Git, and packages for several Linux distributions. ruby-build only knows versions bundled with it, so a newly released Ruby may require upgrading the plugin first. The project supports lockfiles, automatic switching, shell integration, project version pinning, and CI/CD use. rbenv is released under the MIT license, and its listed Free plan costs nothing.

Who it suits

rbenv suits Ruby developers on Linux or macOS who need different versions for projects, shells, or CI/CD. It is focused on Ruby rather than multiple programming languages.

Good to know, and what to watch

  • Automatically switches versions by project directory
  • Supports global, project, and shell selections
  • Plugins can extend default behavior
  • Works in CI/CD workflows
  • Free MIT-licensed open source
  • Ruby installation requires the separate ruby-build plugin
  • New Ruby releases may require upgrading ruby-build
  • Linux and macOS platforms only

Free

Free

Open source

The verdict

rbenv provides focused Ruby version selection with project pinning and shell integration. Its plugin model adds flexibility, while installation of newer Rubies depends on ruby-build definitions.

What the maker publishes

Command shims
rbenv generates shims for Ruby executables to route commands to the selected Ruby version. source
Installation options
The project documents installation through Homebrew on macOS or Linux, Git, and packages for several Linux distributions. source
Intended users
The installer documentation describes rbenv-installer as intended for casual use on a user's own development machine. source
Plugins
rbenv supports plugins that can hook into or override almost any aspect of its default behavior. source
Project selection
rbenv reads a project's .ruby-version file and switches Ruby versions when you change project directories. source
Purpose
rbenv manages Ruby versions on Unix-like systems so projects can use the Ruby version they require. source
Ruby implementations
ruby-build includes definitions for CRuby, JRuby, mruby, picoruby, and TruffleRuby. source
Ruby installation
The rbenv install command is provided by the separate ruby-build plugin, which downloads, compiles, and installs Ruby versions. source
Security and compliance
The repository identifies the project license as MIT. source
Shell and global selection
rbenv can set Ruby versions globally, per project, or for the current shell session. source
Support
The project directs users to its GitHub issue tracker for bugs and ruby-build Discussions for build troubleshooting. source
Version list limit
ruby-build only knows versions bundled with the project, so installing a newly released Ruby version may require upgrading ruby-build first. source

Checked against the maker's pages on 8 Oct 2026.