My previous setup tutorials seemed to help a few people setup their Rails environment so I decided to write this updated version now macOS Catalina has moved over to ZSH as it’s default shell.
Before we start you will need to make sure you have installed NodeJS. If you visit the NodeJS site at https://nodejs.org/ and download and install the LTS package. Once you have done this we can move on.
Next up we need to install Homebrew it comes with a very simple install script. During install you may be asked you to install Xcode Command Line Tools, if so just say yes.
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
With Homebrew installed we can now move on to installing Ruby, the current version at time of writing this is (2.7.0). You will need to enter the following commands into your terminal window.
# Install Ruby. rbenv install 2.7.0 # Set our main version to the latest version. rbenv global 2.7.0 # Check our ruby version. ruby -v
Oh-my-ZSH is a fantastic tool for managing your zsh configuration
sh -c "$(curl -fsSL https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"
at the bottom add the following lines
export PATH="$HOME/.rbenv/bin:$PATH" eval "$(rbenv init -)"
I use Git for my version control system, so we’re going to set it up to match our Github account. If you don’t already have a Github account, make sure you register as it will come in handy for the future.
Replace the example name and email address in the following steps with the ones you used for your Github account.
The next step is to take the newly generated SSH key and add it to your Github account. You want to copy and paste the output of the following command and paste it here.
Once you’ve done this, you can check and see if it worked:
ssh -T [email protected]
You should get a message like this:
Hi r3id! You’ve successfully authenticated, but GitHub does not provide shell access.
brew install yarn
Ride the Rails
Installing Rails is really to install just enter the following command in iTerm2
gem install rails
Rails should now be installed, however for us to use the rails executable, we need to tell
rbenv to see it:
Now lets just double check to make sure Rails has installed correctly. Run the following command in iTerm2
rails -v Rails 6.0.0
Setting up our database
By default Rails uses SQLite3 while this is adequate for developing locally, you will need something better in production. My personal choice is PostgreSQL, so I will cover installing this. But as a side note, you could always use MongoDB, or even MySQL if you wanted to.
We are going to use Homebrew to install our PostgreSQL server and client so open up iTerm2 and enter.
brew install postgresql
To have “launchd” start postgresql at login, you will need to run the following command
brew services start postgresql
The PostgreSQL default user is normally set to your current macOS username and has no password. Check out the PostgreSQL docs for more info.
Let’s create our first Rails site
Open up an iTerm2 window, and we’ll get Rails to generate our new site which we will call “sample-app”.
rails new sample-app -d postgresql
The command will create a new directory called
sample-app and install your Rails app in there. You may have noticed the
-d postgresql, well this tells Rails to set the Database to use PostgreSQL. If you were to leave this off, Rails would by default use SQLite3.
Now we change into the directory that we created.
As a final step, we create the database
Now in a similar method to Jekyll, we run the following command to start up our Rails server.
You could run
rails s or
rails server they are both the same thing its more personal preference.
So now you have Rails setup and your server running, all that’s left to do is to visit http://localhost:3000 to view your new Rails app in your browser of choice.
As a final note, you may need to run to install webpacker, which is what Rails now uses to manage the asset pipeline.