Last modified: Thu Aug 16 2018 22:49:02 GMT+0800 (Malay Peninsula Standard Time)
Chapter 3. MacOS Installation Guide
The following guide was tested only on machine running MacOS Sierra (10.12). If you are using older version of MacOS, this tutorial may not work. At the time this tutorial is being written the latest stable Ruby version for MacOS is Ruby 2.4.0. If any of the command require you to match the Ruby version that you have downloaded, change the version accordingly.
3.1 Ruby Installation
Open a terminal as shown in Figure 3.1.1.
Figure 3.1.1: Terminal Window icon in Applications
The root directory of the terminal as shown in Figure 3.1.2 is your Home directory.
Figure 3.1.2: Terminal Window in MacOS Sierra
By default, modern MacOS come preinstalled with Ruby. To check your Ruby version, enter the command below.
ruby -v
After the command above is inserted, you will see the Ruby version on your terminal window. Figure 3.1.3 shows the terminal window with Ruby version 2.0.0 returned to the terminal window.
Figure 3.1.3: Ruby version
The default Ruby version, Ruby 2.0.0. is old. The latest stable Ruby version for MacOS when this tutorial is written is Ruby 2.4.0. To update your Ruby in your Mac to the latest version, enter the command below. Figure 3.1.4 shows the output after the command is entered into the terminal window.
curl -sSL https://get.rvm.io | bash -s stable --ruby
Figure 3.1.4: Updating Ruby version
If you do not have XCode installed in your machine, a window will pop up and ask you to see if you would like to install XCode. XCode and Git command line are part of the developer tools required in order to update Ruby on your machine. Select Install, as shown in Figure 3.1.5, to install the required files and enter your admin password in the terminal window.
Figure 3.1.5: XCode installation window pop up and Admin password request
A License Agreement window, as shown in Figure 3.1.6 will then pop up. Press "Agree" to continue.
Figure 3.1.6: License Agreement window
If you received Return Error 1
message as shown in Figure 3.1.7, skip to Chapter 3.2. However, if you received an output as shown in Figure 3.1.8, you have successfully updated your Ruby version to Ruby 2.4.0 (as shown in the console output).
Figure 3.1.7: Status 1
error message
Figure 3.1.8: Ruby 2.4.0 installed successfully
Now, set Ruby 2.4.0 as your default Ruby version, enter the command below. Figure 3.1.9 shows the default Ruby version is set to Ruby 2.4.0. If you are not using Ruby 2.4.0, change the number in the command according to the version shown in Figure 3.1.8. If the code does not return a correct Ruby version, please repeat the installation process: rvm use 2.4 --default
To check your updated Ruby version, use the command ruby -v
.
Figure 3.1.7: Ruby 2.4.0 is set as default Ruby version
Proceed to Chapter 3.3 to install Rails.
3.2 Homebrew Installation
If you received Return Error 1
message as shown in Figure 3.2.1, continue reading. If not, proceed to Chapter 3.3 to install Rails.
Figure 3.2.1: Status 1
error message
The reason this error shows up is because you do not have Homebrew installed. To fix this, install Homebrew by entering the command below into your terminal. A confirmation screen, as shown in Figure 3.2.2, will display all the files and scripts that will be installed on your machine. Press return
key to install the files.
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Figure 3.2.2: Homebrew installation confirmation screen
If your machine is password protected, you will asked to enter your password next. Figure 3.2.3 shows the password request window.
Figure 3.2.3: Password request window
Figure 3.2.4 shows Homebrew is installed successfully to your machine. Now, update your Ruby by repeating the process as discussed in Chapter 3.1.
Figure 3.2.4: Homebrew installed successfully
3.3 Rails Installation
To download Rails, enter the code below in a Terminal Window. Figure 3.3.1 shows the input and the output text from the Terminal. This operation can take up to 5 minutes depending on your computer’s processing speed and Internet connection.
gem install rails
Figure 3.2.1 Input and the output text from the Terminal
After the installation is complete, run the following code to check if Ruby is installed successfully. Figure 3.2.2 Rails version in the Terminal Window. If the code does not return a Rails version, please repeat the installation process.
rails -v
Figure 3.2.2: Rails version shown in Terminal Window
3.4 Create a Rails Application
To create your website, it is highly recommending to create a folder name Code in the Ruby file directory. The purpose the folder Code is to store all your source code folder. The Ruby folder location may vary depending on your Operating System Architecture.
Enter the folder Code and create a sample application name Blog. Enter the following command to command line window a similar output as shown in Figure 3.4.1 below will be generated.
rails new Blog
Figure 3.4.1 Generating a new Blog
3.5 Start your server
To start the Web Server, navigate to the folder of your code and run the follow command below. Figure 3.5.1 shows a Rails server is running.
rails s
Figure 3.5.1: A Rails server is running
Insert the URL in your Web Browser based on what you have seen from the Terminal Window to visit your website. Figure 3.5.2 shows a running Ruby on Rails website. Based on the Figure 3.5.1, localhost:3000
is the path to my website.
Figure 3.5.2 A working Ruby on Rails website
3.6 Generate a simple MVC
A second command line window is opened to prevent termination of local Web Server. To verify that Ruby and Rails were installed correctly without any errors, use the scaffold command to generate a simple set of a model, views, and controller for Rails Application.
rails g scaffold User name:string age:integer
A similar output as shown in Figure 3.6.1 will be generated from the command line tool.
Figure 3.6.1: Output of terminal window when a scaffold command is used.
Run the command rake db:migrate to migrate the database generated by the command scaffold to local database server. A similar output as shown Figure 3.6.2 will be generated from the command line tool.
Figure 3.6.2: Output of terminal window when a migrate command is used.
Navigate to the index page of newly generated page by entering the path at your browser. The index page of Users
will be generated as shown in Figure 3.6.3.
localhost:3000/users
Figure 3.6.3: Users
index page
To make sure that the application is working and does not throw any error when new data are committed to the database, press the link New User create a new sample data set. A form will be rendered a shown in Figure 3.6.4. Populate the form with any sample data that you prefer and press Create User.
Figure 3.6.4: New user form
An alert message, as shown in Figure 3.6.5, User was successfully created alert message will be shown on the screen when the data is inserted into the database successfully.
Figure 3.6.5: User was successfully created alert
To redirect to the index page of Users
, press the Back button located under the Age shown in Figure 3.6.5. By looking at Figure 3.6.6, we can see that the Users
index page was being rendered.
Figure 3.6.6: Users
index page was rendered from output log
Figure 3.6.7 shows a picture of Users
index page with the data that populated in the form earlier.
Figure 3.6.7: Users
index page
Congratulation, you have successfully installed Ruby on Rails on your own machine!