Modernize Ruby on Rails
Operational guides for upgrading Ruby on Rails: the Rails 8 upgrade hub, version-to-version migration paths, the test-failure recovery workflow, and legacy app modernization.
Last verified · Updated May 22, 2026
Rails major versions bundle real breaking changes — the Zeitwerk autoloader, asset-pipeline swaps, and the Solid infrastructure adapters. Because upgrades touch the database and deploy stack, they are high-stakes. This hub links every supported upgrade path plus the workflows for the failures those upgrades surface.
What this covers
Start at the Rails 8 upgrade hub for the full breaking-change picture, then pick the source-to-target page that matches the version you run today. Each page includes a repo-inspection prompt, a step-by-step workflow built around bin/rails app:update and config.load_defaults, a test plan, and rollback guidance.
Version timeline
- 8.xcurrentactivereleased 2024-11-07
- 7.xmaintenancereleased 2021-12-15
- 6.xeolreleased 2019-08-16
Rails migration paths
Frequently asked questions
Which Rails version should I target?
Rails 8 is the current stable release. Never skip a major: walk 6 → 7 → 8 one major at a time, advancing config.load_defaults at each stop, so each upgrade stays reviewable and reversible.