101 System requirements

Updated . Posted . Visible to the public.

Rails LTS Show archive.org snapshot has been conceived as a drop-in replacement for Rails 2.3, 3.2, and 4.2. However, we do recommend that you go through the list below to make sure that installing Rails LTS will work without problems.

Rails 2.3 LTS

Rails version

Your application should run the latest release of the official Rails 2.3 gems.

If you are running an earlier version, we strongly recommend upgrading to Rails 2.3.18 before installing Rails LTS.

Ruby version

Rails 2.3 LTS works with Ruby 1.8.7 out of the box.

We also support Ruby 2.5, Ruby 2.7, Ruby 3.1, and Ruby 3.3, however upgrading your Ruby version involves some manual steps.

We do not support Ruby 1.9 for 2.3 LTS.

RubyGems version

Rails 2.3 LTS requires RubyGems < 2. We recommend the latest 1.x release, which is 1.8.30 at the time of writing.

If you are using Rails 2.3 LTS with bundler you can also use current RubyGems versions.

ActiveRecord Database

Your ActiveRecord models should talk to one of the following databases:

  • MySQL (version 5.6)
  • PostgreSQL
  • SQLite3

While other database types might work with Rails 2.3 LTS, we only test against the databases listed above.

Rails 3.2 LTS

Rails version

Your application should run the latest release of the official Rails 3.2 gems.

If you are running an earlier version, we strongly recommend upgrading before installing Rails LTS.

Ruby version

Rails 3.2 LTS is tested against the following Ruby versions:

  • Ruby 1.8.7
  • Ruby 1.9.3
  • Ruby 2.3
  • Ruby 2.5
  • Ruby 2.7
  • Ruby 3.1
  • Ruby 3.3

While other Rubies might work with Rails LTS, we only test against the versions listed above.

Rails 4.2 LTS

Rails version

Your application should run the latest release of the official Rails 4.2 gems.

If you are running an earlier version, we strongly recommend upgrading before installing Rails LTS.

Ruby version

Rails 4.2 LTS is tested against the following Ruby versions:

  • Ruby 2.1
  • Ruby 2.3
  • Ruby 2.5
  • Ruby 2.7
  • Ruby 3.1
  • Ruby 3.3

While other Rubies might work with Rails LTS, we only test against the versions listed above.

Rails 5.2 LTS

Rails version

Your application should run the latest release of the official Rails 5.2 gems.

If you are running an earlier version, we strongly recommend upgrading before installing Rails LTS.

Ruby version

Rails 5.2 LTS is tested against the following Ruby versions:

  • Ruby 2.2
  • Ruby 2.5
  • Ruby 2.7
  • Ruby 3.1
  • Ruby 3.3

While other Rubies might work with Rails LTS, we only test against the versions listed above.

Rails 6.1 LTS

Rails version

Your application should run the latest release of the official Rails 6.1 gems.

If you are running an earlier version, we strongly recommend upgrading before installing Rails LTS.

Ruby version

Rails 6.1 LTS is tested against the following Ruby versions:

  • Ruby 2.5
  • Ruby 2.7
  • Ruby 3.1
  • Ruby 3.3

While other Rubies might work with Rails LTS, we only test against the versions listed above.

Bundler version

Make sure that you have Bundler Show archive.org snapshot 1.11 or newer by running:

gem list | grep bundler

This should show you a line like this:

bundler (1.11.2)

If your version is lower than 1.11, you can should update Bundler.

If you are using Ruby 1.8.7 make sure that you install the latest compatible version:

gem install bundler --version=1.13.7

If you are using Ruby 2, you can install the latest version of Bundler:

gem install bundler

Please note that you need to have a compatible version of Bundler on all PCs that will be running your application (developer boxes, production servers, staging servers).

ActiveRecord Database

Your ActiveRecord models should talk to one of the following databases:

  • MySQL
  • PostgreSQL
  • SQLite3

While other database types might work with Rails LTS, we only test against the databases listed above.

All set?

If your application satisfies the requirements above, you should now subscribe to Rails LTS Show archive.org snapshot and upgrade your application.

If you are still unsure if your application is compatible with Rails LTS, send us an e-mail.

Thomas Eisenbarth
Last edit
Tobias Kraze
Keywords
compatibility
License
Source code in this card is licensed under the MIT License.
Posted by Thomas Eisenbarth to Rails LTS documentation (2013-05-28 14:19)