Need help with asdf-ruby?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

368 Stars 96 Forks MIT License 258 Commits 31 Opened issues


Ruby plugin for asdf version manager

Services available


Need anything else?

Contributors list


Build Status

Ruby plugin for asdf version manager


asdf plugin add ruby

Please make sure you have the required system dependencies installed before trying to install Ruby.


Check asdf readme for instructions on how to install & manage versions of Ruby.

When installing Ruby using

asdf install
, you can pass custom configure options with the env vars supported by ruby-build.

Under the hood, asdf-ruby uses ruby-build to build and install Ruby, check its README for more information about build options and the troubleshooting wiki section for any issues encountered during installation of ruby versions.

You may also apply custom patches before building with

, e.g.
RUBY_APPLY_PATCHES=$'dir/1.patch\n2.patch\n' asdf install ruby 2.4.1
RUBY_APPLY_PATCHES=$(curl -s asdf install ruby 2.1.1

By default asdf-ruby uses the latest release of ruby-build, but you can choose your own branch/tag through the

ASDF_RUBY_BUILD_VERSION=master asdf install ruby 2.6.4

Default gems

asdf-ruby can automatically install a set of default gems right after installing a Ruby version. To enable this feature, provide a

file that lists one gem per line, for example:

You can specify a non-default location of this file by setting a


Migrating from another Ruby version manager


asdf uses the

for auto-switching between software versions. To ease migration, you can have it read an existing
file to find out what version of Ruby should be used. To do this, add the following to
legacy_version_file = yes

If you are migrating from version manager that supported fuzzy matching in

like rvm or chruby, note that you might have to change
to include full version (e.g. change

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.