Sidekiq & Rails Compatibility Table

Sidekiq & Rails Compatibility Table

This article shows the compatibility between Sidekiq opens a new window and Rails opens a new window across different versions. Even though Rails is not a dependency of Sidekiq, there are compatibility considerations for different combinations given that Sidekiq provides integrations with Rails.

If you need help with Sidekiq’s compatibility with Ruby, check this other article opens a new window instead.

Rows highlighted in red, below, indicate Rails versions that have reached the end of their security support.

Rails Versions opens a new window Sidekiq Version opens a new window
8.x >= 8.0.0 opens a new window
7.x >= 6.5.10 opens a new window and >= 8.0.6 opens a new window
6.x >= 6.0.0 opens a new window , < 8.0.0 opens a new window
5.x >= 3.2.6 opens a new window , < 7.0.0 opens a new window
4.x >= 3.0.0 opens a new window , < 6.0.0 opens a new window
3.x >= 1.0.0 opens a new window , < 5.0.0 opens a new window
2.x No sidekiq version supports Rails 2


The information in this table is based on learnings collected during upgrades and also on proof found in the code and official statements of supported versions. Some versions out of the ranges shown here may still work in particular cases depending on the features used by a given application.

To check Sidekiq’s changes through releases, you can check Sidekiq changes opens a new window document in their GitHub repository.

Sidekiq-Ent and Sidekiq-Pro

These gems are private so we can’t inspect all versions to create a similar table, but we recommend checking Sidekiq’s docs which, in some cases, may define supported versions of Rails opens a new window and Sidekiq opens a new window (though not consistently).

Another consideration to keep in mind is that Rails 7.1 adds the connection_pool gem as a dependency opens a new window . When this happens, if not limited (which is the default), Bundler will resolve to version 3 of this gem, but Sidekiq-Ent only adds support of connection_pool 3 in version 8.1.0 opens a new window . Note that this does not mean that older versions of Sidekiq-Ent are not compatible with Rails 7.1+; limiting the version of connection_pool to < 3.0 will also solve the incompatibility.

Need to Upgrade Sidekiq?

If you don’t have the time to do it yourself, you can hire our team to do it for you. Send us a message opens a new window .

Feedback Wanted: Updates

If you find that this article has fallen out of date, feel free to reach out to us on Mastodon opens a new window or Bluesky opens a new window and we will bring it up to speed. We will continue to update this article as new versions of Sidekiq and Ruby are released.

Get the book