This document describes install Rails 2.3 LTS when you are not using Bundler and you do not want to upgrade to Bundler.

If your project does use Bundler, please see our instructions on installing Rails 2.3 LTS with Bundler instead.

Prerequisites

1. Make sure your project satisfies the system requirement for Rails LTS. This involves upgrading to Rails 2.3.18.

Installation

1. Remove all existing version of Rails gems:

   Copy
   gem uninstall rails activeresource actionmailer actionpack activerecord activesupport railslts-version
   

2. Install the latest Rails 2.3 LTS gems.

   As a customer of a paid plan (Startup, Standard, Enterprise), run the following:

   Copy
   gem install rails --version "~> 2.3.18" --source "https://user:password@gems.railslts.com" --no-ri --no-rdoc
   

   Replace username and password with your personal credentials that you received after subscribing to Rails LTS.
   Make sure a colon (:) separates username and password.

   As a subscriber to the free Community edition, you need to build the Rails LTS gems before installing:

   Copy
   git clone -b 2-3-lts https://github.com/makandra/rails.git rails-2-3-lts
   cd rails-2-3-lts
   bundle install
   rake railslts:gems:build
   

   This will build put some .gem files into the pkg/ directory, which you can now install:

   Copy
   gem install --no-ri --no-rdoc pkg/activesupport-2.3.*.gem
   gem install --no-ri --no-rdoc pkg/activerecord-2.3.*.gem
   gem install --no-ri --no-rdoc pkg/actionpack-2.3.*.gem
   gem install --no-ri --no-rdoc pkg/actionmailer-2.3.*.gem
   gem install --no-ri --no-rdoc pkg/activeresource-2.3.*.gem
   gem install --no-ri --no-rdoc pkg/railties-2.3.*.gem
   gem install --no-ri --no-rdoc pkg/railslts-version-2.3.*.gem
   gem install --no-ri --no-rdoc pkg/rails-2.3.*.gem
   

3. Open config/environment.rb within your project directory and look for the following line:

   Copy
   RAILS_GEM_VERSION = '2.3.xx' unless defined? RAILS_GEM_VERSION
   

   Now change that line so it refers to the latest Rails 2.3 LTS version from the Changelog. Note that a Rails LTS version numbers has four dots instead of three:

   Copy
   RAILS_GEM_VERSION = '2.3.xx.yy' unless defined? RAILS_GEM_VERSION
   

4. Decide whether to enable optional security enhancements shipped with Rails LTS.

5. You may want to briefly confirm that you are running the latest version.

6. Follow your normal release process (run tests, push, deploy to staging, do smoke testing, deploy to production).

Congratulations! You successfully deployed your application using Rails LTS. If you have chosen to subscribe to the Rails LTS Notification List when signing up, you will be notified whenever a new patch for Rails LTS becomes available.

Breaking changes

By default, Rails LTS does not allow for strings to be used in polymorphic path helpers, e.g. url_for(['edit', @user]) is not allowed. Symbols are fine. You can opt out of this change