RUBY-BUILD(1)                  ruby-build Manual                 RUBY-BUILD(1)

<?><?><?> (NAME)
       ruby-build - <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?> Ruby

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       ruby-build [-dvpk] <definition> <prefix> [-- <configure-args>...]
       ruby-build {--list|--definitions}
       ruby-build --resolve <version>
       ruby-build --version

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> ruby-build <?><?><?><?><?><?><?> <?><?> Ruby <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?> definition <?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> prefix <?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?> definition <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       bash <?><?><?><?> ruby-build <?><?><?><?><?><?><?><?> (source)
       <?><?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> Ruby <?><?><?> <?><?><?><?><?> configure-args <?><?>
       <?><?> <?><?> <<-->> <?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> ./configure <?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?> <?><?> $TMPDIR/ruby-build.*.log <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?> <?> <?><?><?> <?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> (verbose) <?><?> <?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> <?><?><?><?> (RUBY VERSIONS)
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <<<?><?><?><?><?><?><?><?>>> <?><?><?><?><?><?><?><?> Ruby<?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> --list
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> ruby-build <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> Ruby <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
       Ruby<?> ruby-build <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?> ruby-build <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?> Ruby
       <?><?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> (RUBY IMPLEMENTATIONS)
       <?><?><?><?><?> ruby-build <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?> Ruby <?><?><?><?> <?><?><?><?><?><?>:

       o   CRuby<?> <?><?> <?><?> <?><?><?> <<MRI>> <?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?>: <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <<X.Y.Z>>
           <?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> Ruby <?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?>.

       o   "jruby": <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> Ruby <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> (real threading) <?><?> <?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> (JVM) <?><?><?><?><?>
           <?><?><?> <?><?><?>.

       o   "mruby": <?><?><?><?><?> <?><?><?><?><?><?><?> Ruby <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?>.

       o   "picoruby": <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           mruby <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?>.

       o   "truffleruby": <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?>
           (Native standalone) <?><?> TruffleRuby<?>
           <?><?><?><?><?><?><?><?><?><?> Ruby <?><?> <?><?><?><?>
           <?><?><?><?><?><?> Truffle <?><?> GraalVM.

       o   "truffleruby+graalvm": <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> JVM <?><?> TruffleRuby.

       <?><?><?><?><?><?><?> definition <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> "ruby-" <?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?> CRuby <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> (resolve) <?><?><?><?><?><?>.
       <?><?><?><?><?><?><?> definition <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> Ruby
       <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?>..SH "<?><?><?><?><?><?><?><?> (OPTIONS)"

       -l, --list
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
           Ruby

       --definitions
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?>

       --resolve
           <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> Ruby
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> version

       --version
           <?><?><?><?><?> <?><?><?><?> ruby-build

       -d, --dir
           <?><?><?> Ruby <?><?> <?><?><?><?> prefix/definition
           <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?> prefix

       -v, --verbose
           <?><?><?><?> <?><?><?><?>: <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
           stdout/stderr

       -p, --patch
           <?><?><?><?><?> <?><?> <?><?><?><?> (patch) <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (stdin) <?><?><?>
           <?><?> <?><?><?><?>

       -k, --keep
           <?><?><?> <?><?><?><?> <?><?><?><?> (source tree) <?><?> <?><?>
           <?><?><?><?><?> <?><?><?>

       -4, --ipv4
           <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?><?><?><?><?> IPv4

       -6, --ipv6
           <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?><?><?><?><?> IPv6

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?> <?><?> <?><?><?><?> <?><?> Ruby <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?>:

           $ ruby-build 3.4.9 /path/to/destination -- --disable-install-doc --with-openssl-dir=/opt/openssl

       <?><?><?> <?><?> <?><?><?><?> Ruby <?><?> ~/.rubies/ruby-3.4.9:

           $ ruby-build --dir ruby-3.4.9 ~/.rubies

       <?><?><?> <?><?><?><?><?> <?><?><?><?> Ruby 3.x <?><?>
       ~/.rubies/ruby-3.x.y:

           $ ruby-build --dir ruby-3 ~/.rubies

       <?><?><?> <?><?> <?><?><?><?> Ruby <?><?> ~/.rbenv/versions/3.3.11:

           $ ruby-build --dir 3.3.11 ~/.rbenv/versions

       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> rbenv<?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?>:

           $ rbenv install 3.3.11

           TMPDIR
               <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
               <?><?><?><?> <?><?><?> <?><?><?><?>

           RUBY_BUILD_BUILD_PATH (<?><?><?><?><?><?><?>: <?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?> TMPDIR)
               <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?>
               <?><?><?><?><?><?><?> <?><?><?><?>

           RUBY_BUILD_CACHE_PATH (<?><?><?><?><?><?><?>: "~/.rbenv/cache"
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> rbenv)
               <?><?><?> <?><?><?><?><?><?> <?><?><?><?> (<?><?><?>)
               <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?>

           RUBY_BUILD_HTTP_CLIENT (<?><?><?><?><?><?><?>: <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> PATH)
               <?><?><?> <?><?> <?><?><?><?><?><?><?><?> "aria2c" <?><?>
               "curl" <?><?> "wget" <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
               <?><?><?><?><?><?>

           RUBY_BUILD_ARIA2_OPTS
               <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
               <?><?><?><?><?> <?><?> aria2c <?><?><?> <?><?><?><?><?><?>

           RUBY_BUILD_CURL_OPTS
               <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
               <?><?><?><?><?> <?><?> curl <?><?><?> <?><?><?><?><?><?>

           RUBY_BUILD_WGET_OPTS
               <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
               <?><?><?><?><?> <?><?> wget <?><?><?> <?><?><?><?><?><?>

           RUBY_BUILD_MIRROR_URL (<?><?><?><?><?><?><?>: <?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> Amazon
           CloudFront)
               <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
               <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
               <?><?>

           RUBY_BUILD_MIRROR_PACKAGE_URL
               <?><?><?><?><?> <?><?><?><?><?><?><?><?> (URL) <?><?><?><?> <?>
               <?><?><?><?><?><?> <?><?><?><?>

           RUBY_BUILD_SKIP_MIRROR
               <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?>
               <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
               <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>

           RUBY_BUILD_ROOT (<?><?><?><?><?><?><?>: "share/ruby-build" <?><?>
           <?><?><?> <?><?><?> ruby-build)
               <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
               <?><?><?><?><?><?> <?><?><?><?>

           RUBY_BUILD_TARBALL_OVERRIDE
               <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
               tarball <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
               "#<checksum>" <?><?><?><?><?> <?><?><?>

           RUBY_BUILD_DEFINITIONS
               <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
               <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
               RUBY_BUILD_ROOT

           CC
               <?><?><?><?> <?><?><?><?><?><?><?><?> C

           RUBY_CFLAGS
               <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> CFLAGS <?><?><?><?>
               <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
               Ruby

           CONFIGURE_OPTS
               <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
               "./configure"

           MAKE (<?><?><?><?><?><?><?>: "make")
               <?><?><?><?><?> make <?><?><?><?><?><?> (<?><?><?><?><?>
               "gmake")

           MAKE_OPTS, MAKEOPTS
               <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
               "make"

           MAKE_INSTALL_OPTS
               <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
               "make install"

           RUBY_CONFIGURE_OPTS
               <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> "./configure"
               <?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?> Ruby
               <?><?><?><?><?> <?><?><?><?><?><?><?>

           RUBY_MAKE_OPTS
               <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> make <?><?>
               <?><?><?><?> <?><?><?> <?><?> <?><?><?><?> Ruby <?><?><?><?><?>
               <?><?><?><?><?><?><?>

           RUBY_MAKE_INSTALL_OPTS
               <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> "make
               install" <?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?> Ruby
               <?><?><?><?><?> <?><?><?><?><?><?><?>

           NO_COLOR (<?><?><?><?><?><?><?>: <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?>)
               <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> ANSI
               <?><?> <?><?><?><?><?>

           CLICOLOR_FORCE
               <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> ANSI <?><?>
               <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>
               <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>

               o    <https://github.com/rbenv/ruby-build#readme>

               o    <https://github.com/rbenv/ruby-build/wiki>

               o    <https://github.com/rbenv/ruby-build/discussions>

<?><?><?><?><?><?><?> (AUTHOR)
       Mislav Marohnic

ruby-build 20260520               2026-05-07                     RUBY-BUILD(1)