Ruby plugin for asdf version manager
asdf plugin-add ruby https://github.com/asdf-vm/asdf-ruby.git
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
RUBY_APPLY_PATCHES=$'dir/1.patch\n2.patch\nhttp://example.com/3.patch' asdf install ruby 2.4.1 RUBY_APPLY_PATCHES=$(curl -s https://raw.githubusercontent.com/rvm/rvm/master/patchsets/ruby/2.1.1/railsexpress) asdf install ruby 2.1.1
asdf-ruby can automatically install a set of default gems right after
installing a Ruby version. To enable this feature, provide a
$HOME/.default-gems file that lists one gem per line, for example:
bundler pry gem-ctags
Migrating from another Ruby version manager
asdf uses the
.tool-versions for auto-switching between software versions.
To ease migration, you can have it read an existing
.ruby-version file to
find out what version of Ruby should be used. To do this, add the following to
legacy_version_file = yes
asdf installs Rubies to
$HOME/.asdf/installs/ruby, the directory structure is
the same as other version managers, so you can just move the Rubies to this
mkdir ~/.asdf/installs/ mv ~/.rvm/rubies ~/.asdf/installs/ruby/
mkdir ~/.asdf/installs/ mv ~/.rbenv/versions/* ~/.asdf/installs/ruby/
mkdir ~/.asdf/installs/ mv ~/.rubies ~/.asdf/installs/ruby/