Improve Article
Save Article
Prerequisite: Ruby Programming Language
Before we start with the installation of Ruby on Windows, we must have first-hand knowledge of what Ruby is?. Ruby is a pure Object-Oriented language developed by Yukihiro Matsumoto (also known as Matz in the
Ruby community) in the mid-1990s in Japan. Everything in Ruby is an object except the blocks but there are replacements too for it i.e procs and lambda. The objective of Ruby’s development was to make it act as a sensible buffer between human programmers and the underlying computing machinery.
Ruby is based on many other languages like Perl,
Lisp, Smalltalk, Eiffel and Ada. It is an interpreted scripting language which means most of its implementations execute instructions directly and freely, without
previously compiling a program into machine-language instructions.
Downloading and Installing Ruby
All the versions of Ruby for Windows can be downloaded from rubyinstaller.org. Download the latest version and follow the further instructions for its
Installation.
Beginning with the installation:
Installing MYSYS2 Components:
To check if Ruby installed correctly, perform a version check for the same using the following command on the command-line:
ruby -vHere’s a sample Program to begin with the use of Ruby Programming:
Let’s consider a simple Hello World Program.
Using command-line, run the irb command. After this we can write the ruby code and it will run on command
line.
If you're using Ruby on a Mac, it is set up by default, but you can't modify or upgrade it. Most developers don't use the pre-installed version of Ruby on their Macs. Instead, they configure several systems to help them manage Ruby installation (and other programs), and manage different versions of Ruby. In this lesson, we'll cover installing the version of Ruby and version management tools that are used on Epicodus computers.
Take note: if you run into any error that prevents you from completing all of the installation steps in this lesson, you should still continue with the remaining installation pre-work by installing Postgres.
Also make sure to take detailed notes on any issues that come up, the troubleshooting steps you took to address those issues, and any helpful resources you found along the way. You can share these notes with your peers, and they can share their notes with you.
We'll install Ruby using chruby and ruby-install. If you have installed Ruby before, you may be using RVM (Ruby Version Manager). You may stay with RVM if it is working for you but we recommend using chruby and ruby-install, which we will go over here. To uninstall RVM, type $ rvm implode.
Homebrew Installation
If you do not have Homebrew installed yet, you may install it now by copy and pasting this command into the command line:
$ /bin/bash -c "$(curl -fsSL //raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"This installs Homebrew on your device, a package manager for OS X that makes it easy to install developer software.
Next, ensure Homebrew packages are run before the system versions of the same (which may be dated or not what we want) by executing the following:
For bash users: shell $ echo 'export PATH=/usr/local/bin:$PATH' >> ~/.bash_profile
For zsh users: shell $ echo 'export PATH=/usr/local/bin:$PATH' >> ~/.zshrc
Install ruby-install
To install ruby-install, a tool for installing Ruby, run this command:
$ brew install ruby-installInstall Ruby
To install the version of Ruby we use at Epicodus, run this command:
$ ruby-install ruby 3.1.2If you get the following error configure: error: clang version 3.0 or later is required, you'll need to install Xcode developer tools first:
$ xcode-select –-installOptionally, you can run $ rm -rf ~/src/ to remove the source code that ruby-install downloaded as you won't need it anymore. As always, be very careful using the $ rm -rf command. Alternatively, once you are using VS Code, you can use $ code ~/src/ to open the directory in VS Code, look at the Ruby source code there, and remove it manually.
Install and Configure chruby
To install chruby, a program to manage which versions of Ruby you're using, run this command:
$ brew install chrubyNext, configure your shell's environment variables for chruby by running the following two commands. This will set up bash or zsh to use chruby and also set up auto-switching of Ruby versions.
For bash users:
$ echo 'source /usr/local/opt/chruby/share/chruby/chruby.sh' >> ~/.bash_profile $ echo 'source /usr/local/opt/chruby/share/chruby/auto.sh' >> ~/.bash_profileFor zsh users:
$ echo 'source /usr/local/opt/chruby/share/chruby/chruby.sh' >> ~/.zshrc $ echo 'source /usr/local/opt/chruby/share/chruby/auto.sh' >> ~/.zshrcTo set your default Ruby version to 3.1.2, run this command:
$ echo "ruby-3.1.2" > ~/.ruby-versionThe last configuration I'd recommend is to not install documentation when you install Ruby gems. Why? It takes longer than installing the gems themselves, and better documentation is available online. Optionally, run this command:
$ echo "gem: --no-rdoc --no-ri" > ~/.gemrcVerify Your Ruby Installation
In your Terminal, run this command to verify the version of Ruby you've installed:
$ ruby -vAlso, confirm that you can access IRB (a REPL, which we'll learn more about soon):
$ irb irb(main):001:0>To exit IRB, enter exit.
Install Rails
Finally, verify that you can install Rails at the same version we use at Epicodus:
$ gem install rails -v 7.0You can verify that Rails is working by navigating to the desktop and creating a new project:
$ rails new test_projectIt will take a little time for Rails to spin up a new project. Once it's complete, cd into test_project and start the Rails server:
$ rails sYou should see a message similar to the following:
Puma starting in single mode... * Puma version: 5.6.4 (ruby 3.1.2-p20) ("Birdie's Version") * Min threads: 5 * Max threads: 5 * Environment: development * PID: 19756 * Listening on //[::1]:3000 * Listening on //127.0.0.1:3000If not, remember to copy and paste the entire error log into a document that you can share with your instructor. To close the server enter ctrl + c.
After you've completed these steps, delete the test_project directory.
And with that, you're ready to go!
Next steps
Check out the READMEs for chruby and ruby-install, or at least bookmark them for later, so you know how to install other versions of Ruby and switch between them as needed. There's also an upcoming lesson on Managing Ruby Versions that goes into detail about using the tools ruby-install and chruby.
Otherwise, continue working through the Ruby and Rails pre-work!
Lesson 3 of 7
Last updated more than 3 months ago.