NAME

ronin-install - Installs Ruby, JRuby, TruffleRuby, or mruby

SYNOPSIS

ruby-install [options] [[RUBY | VERSION | RUBY-VERSION] [-- CONFIGURE_OPTS ...]]

DESCRIPTION

Installs a version of Ruby, JRuby, TruffleRuby, or mruby.

https://github.com/postmodern/ruby-install#readme

ARGUMENTS

RUBY: Install Ruby by name. Must be either ruby, jruby, truffleruby, or mruby.
VERSION: Optionally select the version of selected Ruby.
CONFIGURE_OPTS: Additional optional configure arguments.

OPTIONS

-r, --rubies-dir DIR: Specifies the alternate directory where other Ruby directories are installed, such as ~/.rvm/rubies or ~/.rbenv/versions. Defaults to /opt/rubies for root and ~/.rubies for normal users.
-i, --install-dir DIR: Specifies the directory where Ruby will be installed. Defaults to /opt/rubies/$ruby-$version for root and ~/.rubies/$ruby-$version for normal users.
--prefix DIR: Alias for -i DIR.
--system: Alias for -i /usr/local.
-s, --src-dir DIR: Specifies the directory for downloading and unpacking Ruby source.
-c, --cleanup: Remove the downloaded Ruby archive and unpacked source-code after installation.
-j, --jobs NUM, -jNUM, --jobs=NUM: Specifies the number of make jobs to run in parallel when compiling Ruby. If the -j option is provided without an argument, make will allow an unlimited number of simultaneous jobs.
-p, --patch {FILE | URL}: Specifies any additional patches to apply.
-M, --mirror URL: Specifies an alternate mirror to download the Ruby archive from.
-u, --url URL: Alternate URL to download the Ruby archive from.
-m, --md5 MD5: Specifies the MD5 checksum for the Ruby archive.
--sha1 SHA1: Specifies the SHA1 checksum for the Ruby archive.
--sha256 SHA256: Specifies the SHA256 checksum for the Ruby archive.
--sha512 SHA512: Specifies the SHA512 checksum for the Ruby archive.
--package-manager [apt|dnf|yum|pacman|zypper|brew|pkg|port]: Use an alternative package manager.
--no-download: Use the previously downloaded Ruby archive.
--no-verify: Do not verify the downloaded Ruby archive.
--no-extract: Do not extract the downloaded Ruby archive. Implies --no-download and --no-verify.
--no-install-deps: Do not install build dependencies before installing Ruby.
--no-reinstall: Skip installation if another Ruby is detected in same location.
-U, --update: Downloads the latest ruby versions and checksums from the ruby-versions repository (https://github.com/postmodern/ruby-versions#readme).
-D, --debug: Enable debugging messages.
-V, --version: Prints the current ruby-install version.
-h, --help: Prints a synopsis of ruby-install usage.

EXAMPLES

List supported Rubies and their major versions:

$ ruby-install

List the latest versions:

$ ruby-install --latest

Install the current stable version of Ruby:

$ ruby-install ruby

Install the latest version of Ruby:

$ ruby-install --latest ruby

Install a latest version of Ruby:

$ ruby-install ruby 3.1

Install a specific version of Ruby:

$ ruby-install ruby 3.1.2

Install a Ruby into a specific directory:

$ ruby-install --install-dir /path/to/dir ruby

Install a Ruby into a specific rubies directory:

$ ruby-install --rubies-dir /path/to/rubies/ ruby

Install a Ruby into /usr/local:

$ sudo ruby-install --system ruby 3.1.2

Install a Ruby from a mirror:

$ ruby-install -M http://www.mirrorservice.org/sites/ftp.ruby-lang.org/pub/ruby ruby 2.4.0

Install a Ruby with a specific patch:

$ ruby-install -p https://raw.github.com/gist/4136373/falcon-gc.diff ruby 1.9.3-p551

Install a Ruby with specific configuration:

$ ruby-install ruby 3.1.2 -- --enable-shared --enable-dtrace CFLAGS="-O3"

Install CRuby with jemalloc support:

$ ruby-install ruby 3.1.2 -- --with-jemalloc

Install CRuby with YJIT support:

$ ruby-install ruby 3.2.0 -- --enable-yjit

Using ruby-install with [RVM]:

$ ruby-install --rubies-dir ~/.rvm/rubies ruby 3.1.2

Using ruby-install with [rbenv]:

$ ruby-install -i ~/.rbenv/versions/2.4.0 ruby 3.1.2

Uninstall a Ruby version:

$ rm -rf ~/.rubies/ruby-3.1.2

FILES

/usr/local/src: Default root user source directory.
~/src: Default non-root user source directory.
/opt/rubies/$ruby-$version: Default root user installation directory.
~/.rubies/$ruby-$version: Default non-root user installation directory.

ENVIRONMENT

RUBY_INSTALL_SRC_DIR: Overrides the default source directory.
RUBY_INSTALL_RUBIES_DIR: Overrides the default installation directory.
RUBY_INSTALL_PKG_MANAGER: Explicitly sets the package manager to use.

AUTHOR

Postmodern postmodern.mod3@gmail.com