Posted over 3 years ago. Visible to the public.

Installing Rails 2.3 LTS without Bundler

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.


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


  1. Remove all existing version of Rails gems:

    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:

    gem install rails --version "~> 2.3.18" --source "" --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:

    git clone -b 2-3-lts 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:

    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:

    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:

    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.

Author of this card:

Henning Koch
Last edit:
over 1 year ago
by Henning Koch
13 cards