|
| 1 | +--- |
| 2 | +layout: page |
| 3 | +title: Download Ruby |
| 4 | +--- |
| 5 | + |
| 6 | +Here you can get the latest Ruby distributions in your favorite flavor. |
| 7 | +The current stable version is 1.9.2. Please be sure to read |
| 8 | +[Ruby’s License](/about/license.txt). |
| 9 | + |
| 10 | +### Ruby Source Code |
| 11 | + |
| 12 | +Installing from the source code is a great solution for when you are comfortable enough with your platform and perhaps need specific settings for your environment. It’s also a good solution in the event that there are no other premade packages for your platform. |
| 13 | + |
| 14 | +{% for download in site.downloads.source %} |
| 15 | +* [{{ download.name }}]({{ download.url }}) {% if download.md5 != null %}(md5: {{ download.md5 }}){% endif %} {% if download.comment != null %} {{ download.comment }}{% endif %} |
| 16 | +{% endfor %} |
| 17 | + |
| 18 | +For information about the Ruby Subversion and Git repositories, see our |
| 19 | +[Ruby Core](/community/ruby-core/) page. |
| 20 | + |
| 21 | +### Ruby on Windows |
| 22 | + |
| 23 | +The Windows platform has several options to install Ruby. |
| 24 | +The first option is to use the [RubyInstaller](http://rubyinstaller.org/), |
| 25 | +an installer that contains compiled binaries. The second option is usage of |
| 26 | +packaged executables and binaries. If you’re unsure about how to |
| 27 | +install Ruby, the first option might be the best for you. |
| 28 | + |
| 29 | +{% for download in site.downloads.windows %} |
| 30 | +* [{{ download.name }}]({{ download.url }}) {% if download.md5 != null %}(md5: {{ download.md5 }}){% endif %} {% if download.comment != null %}{{ download.comment }}{% endif %} |
| 31 | +{% endfor %} |
| 32 | + |
| 33 | +Please note that using the above indicated binaries will require manual |
| 34 | +download and installation of additional components detailed on |
| 35 | +[this page](http://www.garbagecollect.jp/ruby/mswin32/en/documents/install.html). |
| 36 | +Please ensure you have followed and performed these steps prior reporting a bug. |
| 37 | + |
| 38 | +The [RubyInstaller](http://rubyinstaller.org/) does not require these additional tasks. |
| 39 | + |
| 40 | +Please also investigate the use of [pik](http://github.com/vertiginous/pik) |
| 41 | +which eases the process of installing and maintaining concurrent versions of |
| 42 | +both ruby and gems on Windows. |
| 43 | + |
| 44 | +### Ruby On Linux |
| 45 | + |
| 46 | +Depending on the distribution you are using, there are several ways to |
| 47 | +install Ruby. The first option is simply to download the source code above |
| 48 | +and compile by hand. However, on some platforms, there are package management |
| 49 | +solutions that make installing Ruby extremely easy. There is also `rvm`, the |
| 50 | +[Ruby Version Manager](http://rvm.beginrescueend.com), which eases the process |
| 51 | +of installing and maintaining concurrent versions of both ruby and gems. |
| 52 | +This software may become the default installation choice for newcomers as it |
| 53 | +is quite straightforward to use. If however you would like to stick to your |
| 54 | +distribution package system, read on. |
| 55 | + |
| 56 | +For example, on Debian or Ubuntu `apt-get` provides an easy and elegant solution: |
| 57 | + |
| 58 | + % sudo apt-get install ruby1.9.1-full |
| 59 | + |
| 60 | +The above command installs the current stable version of Ruby 1.9.1. |
| 61 | +If you prefer to install a Ruby 1.8 version, you can use: |
| 62 | + |
| 63 | + % sudo apt-get install ruby-full |
| 64 | + |
| 65 | +For irb and rdoc, you will need to enable the universe repository. |
| 66 | + |
| 67 | +### Ruby On OS X |
| 68 | + |
| 69 | +Ruby 1.8.6 is fully supported in Mac OS X Leopard including Ruby on Rails, |
| 70 | +Mongrel, Capistrano, and many other popular Ruby gems (packages). |
| 71 | +For details, see the [Ruby wiki at MacOS Forge](http://trac.macosforge.org/projects/ruby/wiki). |
| 72 | + |
| 73 | +Mac OS X Tiger is packaged with version 1.8.2 of Ruby, but, for those who |
| 74 | +haven’t upgraded to Leopard, there are a number of options for |
| 75 | +installing the latest version of Ruby. [Locomotive](http://locomotive.raaum.org/) |
| 76 | +is a nice choice if you are looking for something to get you up and running |
| 77 | +quickly for Rails development. Using [MacPorts](http://www.macports.org/) or |
| 78 | +[Fink](http://fink.sourceforge.net/) might be a little nicer for the more |
| 79 | +technically savvy. |
| 80 | + |
| 81 | +On MacPorts, you can install Ruby with… |
| 82 | + |
| 83 | + % sudo port install ruby |
| 84 | + |
| 85 | +Fink has a graphical interface (using Fink Commander) for installing Ruby. |
| 86 | + |
| 87 | +Also, since OS X is based on Unix, downloading and installing from the source |
| 88 | +is just as easy and effective as the other solutions. |
| 89 | + |
| 90 | +For a detailed look at installing Ruby (and Rails), Dan Benjamin’s |
| 91 | +excellent articles [for Tiger](http://hivelogic.com/articles/ruby-rails-mongrel-mysql-osx), |
| 92 | +[for Leopard](http://hivelogic.com/articles/ruby-rails-leopard), and |
| 93 | +[for Snow Leopard](http://hivelogic.com/articles/compiling-ruby-rubygems-and-rails-on-snow-leopard/) |
| 94 | +will get you up and running very quickly. |
| 95 | + |
| 96 | +### Ruby On Solaris and OpenSolaris |
| 97 | + |
| 98 | +Ruby 1.8.7 are available for Solaris 8 through Solaris 10 on [Sunfreeware](http://www.sunfreeware.com) |
| 99 | +and Ruby 1.8.7 is available at [Blastwave](http://www.blastwave.org). |
| 100 | +Ruby 1.9.2p0 is also available at [Sunfreeware](http://www.sunfreeware.com) now. |
| 101 | +An optimized Ruby on Rails stack for Solaris 10 is available as |
| 102 | +[Coolstack](http://cooltools.sunsource.net/coolstack) from Sun’s |
| 103 | +Cooltools project. |
| 104 | + |
| 105 | +To install Ruby on [OpenSolaris](http://www.opensolaris.org), please use the |
| 106 | +[Image Packaging System, or IPS](http://opensolaris.org/os/project/pkg/) client. |
| 107 | +This will install the latest Ruby binaries and Rubygems directly from the |
| 108 | +OpenSolaris network repository. It’s easy: |
| 109 | + |
| 110 | + % pfexec pkg install SUNWruby18 |
| 111 | + |
| 112 | +This will install Ruby, Rubygems, common extensions and their supporting libraries. |
| 113 | +This package also contains DTrace support and performance optimizations. |
| 114 | +The locations of various artifacts are described in the |
| 115 | +[Ruby OpenSolaris ARC Case](http://jp.opensolaris.org/os/community/arc/caselog/2007/600/). |
| 116 | + |
| 117 | +The other OpenSolaris distribution, called the [Solaris Express Community Edition or SXCE](http://opensolaris.org/os/downloads) |
| 118 | +comes with Ruby preinstalled. The version, location etc., are the same as |
| 119 | +with the vanilla OpenSolaris distribution, and are documented in the above |
| 120 | +mentioned ARC case. |
| 121 | + |
| 122 | +To install SVR4 packages manually, please visit the |
| 123 | +[RubyOpenSolaris project @ Rubyforge](http://rubyforge.org/projects/rubyopensolaris). |
0 commit comments