Learn how to set up your Ruby environment on Windows
While there are several ways to get Ruby on Windows, we recommend using the latest RubyInstaller for Windows. To get started…
Go to the RubyInstaller download page and download the latest Ruby+Devkit (x64) version 3.1 or newer.
Run the installer (leaving the default options is fine). When finished installing, keep the
Run 'ridk install' option selected to install MSYS2 and the development toolchain.
When prompted for “Which components shall be installed”, just press “enter” to install everything needed. When finished installing, press “enter” again to quit.
To start using Ruby, we also recommend the new Windows Terminal, which is easy to set up and provides access to multiple shells all in one view. You can download it here from the Microsoft Store for free.
After installing, open Windows Terminal and click the drop-down icon (
˅) and select
+ Add a new profile then
+ New empty profile. Enter a name for the profile, like
Ruby or whatever you like. For
Command line, enter this text:
C:\Ruby31-x64\msys64\msys2_shell.cmd -defterm -here -no-start -ucrt64
(If you installed Ruby in a different location, update the path accordingly.) You can also set the
Starting directory to anything you like, but we recommend just unchecking the box
Use parent process directory, then
%USERPROFILE% should appear. The rest of the fields are optional. Click
Now, click the drop-down icon (
˅) again and select your new Ruby profile. You should see a new tab open with a prompt that looks something like this:
Me@DESKTOP-PB7BDLT UCRT64 /c/Users/Me $
To give the shell access to Ruby, run the following command:
echo 'export PATH=$PATH:/c/Ruby31-x64/bin' >> ~/.bash_profile
(Again, if you installed Ruby in a different location, you’ll need to update this directory path.) Run
source ~/.bash_profile to make that change take effect in the current shell. Check to make sure Ruby is ready to go by running
ruby -v. You should see Ruby print its version number and other information, like this:
$ ruby -v ruby 3.1.1p18 (2022-02-18 revision 53f5fc4236) [x64-mingw-ucrt]
That’s it! You’re ready to install the gem and write your first 2D app »