28 cards
Posted over 9 years ago. Visible to the public.

Installing Rails 2.3 LTS without Bundler

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

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 "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:

    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:

    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 three dots instead of two:

    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
  • Mimicking Rails 5, Rails 2.3 LTS will try to use YAML.safe_load to deserialize certain database column. See details

makandra has been working exclusively with Ruby on Rails since 2007. Our laser focus on a single technology has made us a leader in this space.

Owner of this card:

Henning Koch
Last edit:
6 days ago
by Tobias Kraze
About this deck:
We are makandra and do test-driven, agile Ruby on Rails software development.
License for source code
This website uses short-lived cookies to improve usability.
Accept or learn more