There are few ways we can create an application with specific rails version.
In this article, we will create a new rails app of version
4.2.1 while our system may have multiple rails versions installed in our system.
Here is the list of rails versions that were already installed in my system while writing this article.
rails (5.0.0.beta3, 5.0.0.beta2, 22.214.171.124, 126.96.36.199, 4.2.4, 4.2.1)
Method 1: Common method
Let’s start with most common and widely documented method:
rails version new app_name
Let’s create an app named
my_app with rails version
rails _4.2.1_ new my_app
Sometimes, this method does not work, I have not yet been able to identify reasons behind it. Please leave comment below if you know or have some assumptions on why this method fails sometimes. Several people have reported this method to be failing sometimes and they had been using latest/other version instead.
Method 2: Let bundler handle the rails version
In this method we will let
bundler handle rails version.
Our workflow if we wanted to setup new project with rails version
4.2.1 would be:
2.1: Make new folder and initialise bundler
# make directory for new rails app mkdir my_app cd my_app # specify ruby version we want to use echo 2.4.1 > .ruby-version # initialise bundler (creates Gemfile) bundler init
2.2: Specify rails version
At this stage, our
Gemfile probably looks like this:
# A sample Gemfile source "https://rubygems.org" # gem "rails"
We have to uncomment rails gem and specify version so that our
Gemfile looks like this:
# A sample Gemfile source "https://rubygems.org" gem "rails", '4.2.1'
Now we need to run
bundle install. (This would install
rails 4.2.1 if it had not been installed yet).
2.3: Initialise new rails app with specified rails version
At this point we already have minimal project with rails version
Now, we can use the rails command line tool with bundle exec to force the version:
bundle exec rails new . --force # --force to overrite curent Gemfile
If you were unaware about rails runtime option
force, it is used to overwrite files that already exist. Just type
rails in your commandline and you will see explanation about this command.
Now, we have new rails project with our desired rails version(
What do you think about this flow of setting up version specific new rails project? Feel free to comment.