Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
112 lines (66 sloc) 4.06 KB

130 Installing Ruby with MSYS2 on Windows 10

Important: If you have an existing installation of Ruby, make sure you completely remove the installation before proceeding with the steps below. Check to see if you have C:\DevKit or C:\Ruby*\ folders that may be previous installations Ruby on Windows.

If you run into any errors during this guide, check the Errors and Solutions for the causes.

64bit Windows 10

Download Ruby+Devkit 2.5.1-1 (x64) from

Ruby+Devkit 2.5.1-1 (x64)

32bit Windows 10

Download Ruby+Devkit 2.5.1-1 (x86) from

Ruby+Devkit 2.5.1-1 (x86)

Run Ruby Installer

Double-click RubyInstaller and select:

  • Check "I accept the License"
  • Click Next

Accept License

  • Use default Ruby installation folder: C:\Ruby25-x64 or C:\Ruby25-x86
  • Check "Add Ruby executables to your PATH"
  • Check "Associate .rb and .rbw files with this Ruby installation"
  • Check "Use UTF-8 as default external encoding."
  • Click Install

Installation Destination and Optional Tasks

  • Check "MSYS2 development toolchain"
  • Click Next

Select Components

The installation may take around 5 to 10 minutes.

  • Check "Run 'ridk install' to setup MSYS2 and development toolchain."
  • Click Finish

Setupe Select MSYS2

A RubyInstaller2 "cmd.exe" window will open up with choices.


  • Click ENTER

Ruby Installer 2

The installation may take an additional 5 to 10 minutes. At the end it should say "MSYS2 seems to be properly installed", you can ignore other errors.

  • Close installer

MSYS2 Properly Installed

Update RubyGems and Install Bundler

Open Command Prompt and update RubyGems command and install Bundler

gem update --system --no-document 
# Allow access (check all options) if Windows Security Alert displays.

gem --version

  2.7.6    # Or greater!

gem install bundler --no-document
# Overwrite executable? Type "y" and hit Enter if this appears.

bundle --version

  Bundler version 1.16.2    # Or greater!

Verify Installation (Optional)

Open Command Prompt

gem install rdiscount --platform=ruby --no-document

You should see Temporarily enhancing PATH for MSYS/MINGW..., type the following to confirm the gem works:

ruby -rubygems -e "require 'rdiscount'; puts'**Hello RubyInstaller**').to_html"

It should output:

<p><strong>Hello RubyInstaller</strong></p>

Next Step

You have successfully installed Ruby on Windows. If you have been directed here from installation instructions for the NSRR gem, Edfize, or Spout, you can now return to continue the gem installation instructions.

For those installing the entire Rails stack, continue below.

135 - Install MySQL