Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
ruby-install(1)			 User Manuals		       ruby-install(1)

SYNOPSIS

       ruby-install  [OPTIONS]	[[RUBY	|  VERSION | RUBY-VERSION] [-- CONFIG-
	      URE_OPTS...]]

DESCRIPTION
       Installs	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.   De-
	      faults 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-$ver-
	      sion 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 af-
	      ter installation.

       -j, --jobs NUM, -jNUM, --jobs=NUM
	      Specifies	the number of make jobs	to run in parallel  when  com-
	      piling  Ruby.  If	the -j option is provided without an argument,
	      make will	allow an unlimited number of simultaneous jobs.

       -p, --patch FILE
	      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-down-
	      load 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/postmod-
	      ern/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:

       $ ruby-install --system ruby 3.1.2

       Install a Ruby from an official site with directly download:

       $ ruby-install -M https://ftp.ruby-lang.org/pub/ruby 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"

       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>

SEE ALSO
       ruby(1),	gem(1),	chruby(1), chruby-exec(1)

ruby-install			   Aug 2018		       ruby-install(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ruby-install&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help