ruby-build - Online in the Cloud

PROGRAM:

NAME

ruby-build - utility to compile and install Rubies

SYNOPSIS

ruby-build [OPTIONS...] DEFINITION PREFIX

ruby-build --definitions

ruby-build --version

ruby-build [-h|--help]

rbenv install [OPTIONS...] [DEFINITION]

rbenv install [-l|--list]

rbenv uninstall [-f|--force] DEFINITION

DESCRIPTION

ruby-build provides a simple way to compile and install different versions of Ruby on
UNIX-like systems.

ruby-build downloads, builds and installs the Ruby version specified in a DEFINITION into
a PREFIX directory. Definitions can be chosen from the list of installed definitions or by
specifying a file path for a definition.

rbenv(1) users can also use the provided rbenv install command, which installs Rubies into
the rbenv directory.

OPTIONS

--definitions
List available definitions.

-f, --force
When using rbenv-install, force installation of Ruby versions that are already
installed. When using rbenv-uninstall, uninstall without prompting for confirmation or
displaying an error message for Rubies that are not currently installed.

-k, --keep
Don’t delete source code after installation.

-p, --patch
Apply a patch from standard input to the Ruby, JRuby or Rubinius source code before
executing the ./configure step.

-v, --verbose
Display compiler messages on standard output.

--version
Show ruby-build version and exit.

-h, --help
Show usage information and exit.

EXAMPLES

Install Ruby 2.0.0 (MRI, patch level 0) to ~/rubies/mri-2.0.0:

ruby-build 2.0.0-p0 ~/rubies/mri-2.0.0

Install Ruby Enterprise Edition 1.8.7 (patch level 2011.03) for rbenv(1):

rbenv install ree-1.8.7-2011.03

Install local app-specific Ruby version:

rbenv install

Install Ruby from a custom definition into ~/your-ruby:

rbenv install /path/to/your/own/ruby/definition ~/your-ruby

Install Ruby 2.0.0-p0, applying the patch in /path/to/some.patch:

rbenv install --patch 2.0.0-p0 < /path/to/some.patch

ENVIRONMENT

CC
Sets the path to the C compiler.

CONFIGURE_OPTS
Options that are passed to ./configure when building a Ruby.

MAKE
Sets the command used for make.

MAKE_OPTS
Options that are passed to make when building a Ruby.

MAKEOPTS
Used instead of MAKE_OPTS when MAKE_OPTS is not defined.

RUBY_BUILD_BUILD_PATH
Sets the location in which sources are downloaded and built.

RUBY_BUILD_CACHE_PATH
Sets the location where downloaded package files are cached.

RUBY_BUILD_DEFINITIONS
Adds a colon-separated list of directories to the build definition path.

RUBY_BUILD_MIRROR_URL
Sets the root URL of the mirror from which package files are downloaded.

RUBY_BUILD_ROOT
If set, overrides the default location from where build definitions in
share/ruby-build/ are looked up.

RUBY_BUILD_SKIP_MIRROR
If set, forces ruby-build to download packages from their original source URLs instead
of using a mirror.

RUBY_CFLAGS
Options that are added to the default CFLAGS when building a Ruby.

RUBY_CONFIGURE_OPTS
Options that are passed to ./configure when building a Ruby. In contrast to
CONFIGURE_OPTS, these are only passed to Ruby and not to any dependent packages (such
as libyaml).

RUBY_MAKE_OPTS
Options that are passed to make when building a Ruby. In contrast to MAKE_OPTS, these
are only passed to Ruby and not to any dependent packages (such as libyaml).

TMPDIR
Sets the location where ruby-build stores temporary files.

AUTHORS

ruby-build is developed by Sam Stephenson <[email protected]>.

This man page was written for the Debian GNU/Linux distribution by Sebastian Boehm
<[email protected]> but may be used by others.

Use ruby-build online using onworks.net services