2012-08-07 16:01:34 -04:00
Sidekiq
2012-01-21 16:42:21 -08:00
==============
2012-01-16 15:17:42 -08:00
2015-02-18 17:32:12 -07:00
[](https://rubygems.org/gems/sidekiq)
[](https://codeclimate.com/github/mperham/sidekiq)
2019-04-18 09:54:28 -07:00
[](https://circleci.com/gh/mperham/sidekiq/tree/master)
2015-02-18 17:32:12 -07:00
[](https://gitter.im/mperham/sidekiq)
2013-03-11 18:40:11 -07:00
2012-08-07 16:01:34 -04:00
2013-06-25 21:55:51 -07:00
Simple, efficient background processing for Ruby.
2012-01-21 16:42:21 -08:00
2013-06-25 21:55:51 -07:00
Sidekiq uses threads to handle many jobs at the same time in the
2012-08-30 21:02:49 -07:00
same process. It does not require Rails but will integrate tightly with
2016-02-22 20:34:16 -08:00
Rails to make background processing dead simple.
2012-04-05 19:20:24 -07:00
2012-03-26 10:26:05 -03:00
Sidekiq is compatible with Resque. It uses the exact same
2012-02-05 07:55:18 -08:00
message format as Resque so it can integrate into an existing Resque processing farm.
2012-01-21 16:42:21 -08:00
You can have Sidekiq and Resque run side-by-side at the same time and
2013-06-25 21:55:51 -07:00
use the Resque client to enqueue jobs in Redis to be processed by Sidekiq.
2012-01-21 16:42:21 -08:00
2016-04-26 10:25:16 -07:00
Performance
---------------
2015-11-20 16:03:35 -08:00
2015-11-20 16:04:52 -08:00
Version | Latency | Garbage created for 10,000 jobs | Time to process 100,000 jobs | Throughput
2015-11-20 16:03:35 -08:00
-----------------|------|---------|---------|------------------------
Sidekiq 4.0.0 | 10ms | 151 MB | 22 sec | **4500 jobs/sec**
Sidekiq 3.5.1 | 22ms | 1257 MB | 125 sec | 800 jobs/sec
Resque 1.25.2 | - | - | 420 sec | 240 jobs/sec
DelayedJob 4.1.1 | - | - | 465 sec | 215 jobs/sec
2012-01-21 16:42:21 -08:00
2017-06-02 16:41:21 -07:00
< small > This benchmark can be found in `bin/sidekiqload` .</ small >
2012-01-21 16:42:21 -08:00
Requirements
-----------------
2017-01-17 13:02:06 -08:00
Sidekiq supports CRuby 2.2.2+ and JRuby 9k.
2013-09-22 14:24:23 -07:00
2017-01-17 13:02:06 -08:00
All Rails releases >= 4.0 are officially supported.
2012-01-21 16:42:21 -08:00
2015-11-20 16:03:35 -08:00
Redis 2.8 or greater is required. 3.0.3+ is recommended for large
installations with thousands of worker threads.
2012-07-25 18:41:05 -07:00
2012-01-21 16:42:21 -08:00
Installation
-----------------
2012-06-27 10:52:06 +10:00
gem install sidekiq
2012-01-21 16:42:21 -08:00
2012-01-25 21:12:18 -08:00
Getting Started
2012-01-21 16:42:21 -08:00
-----------------
2015-08-25 17:04:09 +01:00
See the [Getting Started wiki page ](https://github.com/mperham/sidekiq/wiki/Getting-Started ) and follow the simple setup process.
2016-11-11 10:04:56 -05:00
You can watch [this Youtube playlist ](https://www.youtube.com/playlist?list=PLjeHh2LSCFrWGT5uVjUuFKAcrcj5kSai1 ) to learn all about
Sidekiq and see its features in action. Here's the Web UI:
2013-03-16 15:31:06 -07:00
2012-01-21 16:42:21 -08:00
2013-04-09 15:25:15 -07:00
Want to Upgrade?
2013-04-08 08:33:37 -07:00
-------------------
2015-08-17 15:31:11 -07:00
I also sell Sidekiq Pro and Sidekiq Enterprise, extensions to Sidekiq which provide more
features, a commercial-friendly license and allow you to support high
2013-04-08 08:33:37 -07:00
quality open source development all at the same time. Please see the
2019-07-11 11:11:35 -07:00
[Sidekiq ](https://sidekiq.org/ ) homepage for more detail.
2013-04-08 08:33:37 -07:00
2016-03-03 12:58:44 -08:00
Subscribe to the ** [quarterly newsletter ](https://tinyletter.com/sidekiq )** to stay informed about the latest
2016-02-05 13:30:34 -08:00
features and changes to Sidekiq and its bigger siblings.
2012-01-21 16:42:21 -08:00
2016-01-20 13:50:54 -08:00
Problems?
2012-01-24 18:07:18 -08:00
-----------------
2016-01-20 13:50:54 -08:00
**Please do not directly email any Sidekiq committers with questions or problems.** A community is best served when discussions are held in public.
2016-02-05 13:30:34 -08:00
If you have a problem, please review the [FAQ ](https://github.com/mperham/sidekiq/wiki/FAQ ) and [Troubleshooting ](https://github.com/mperham/sidekiq/wiki/Problems-and-Troubleshooting ) wiki pages.
Searching the [issues ](https://github.com/mperham/sidekiq/issues ) for your problem is also a good idea.
2016-01-20 14:00:49 -08:00
2019-07-11 11:11:35 -07:00
Sidekiq Pro and Sidekiq Enterprise customers get private email support. You can purchase at https://sidekiq.org; email support@contribsys .com for help.
2017-10-10 09:41:14 -07:00
2016-02-05 13:30:34 -08:00
Useful resources:
2012-01-24 18:07:18 -08:00
2016-02-05 13:30:34 -08:00
* Product documentation is in the [wiki ](https://github.com/mperham/sidekiq/wiki ).
2019-07-11 11:11:35 -07:00
* Occasional announcements are made to the [@sidekiq ](https://twitter.com/sidekiq ) Twitter account.
2016-02-05 13:30:34 -08:00
* The [Sidekiq tag ](https://stackoverflow.com/questions/tagged/sidekiq ) on Stack Overflow has lots of useful Q & A.
2012-06-19 12:26:36 -07:00
2016-09-14 11:54:38 -07:00
Every Friday morning is Sidekiq happy hour: I video chat and answer questions.
2019-07-11 11:11:35 -07:00
See the [Sidekiq support page ](https://sidekiq.org/support.html ) for details.
2014-04-18 19:59:44 -07:00
2012-01-24 19:44:57 -08:00
License
-----------------
2013-04-15 13:48:12 -03:00
Please see [LICENSE ](https://github.com/mperham/sidekiq/blob/master/LICENSE ) for licensing details.
2012-01-24 19:44:57 -08:00
2012-01-21 16:42:21 -08:00
Author
-----------------
2019-07-11 11:11:35 -07:00
Mike Perham, [@mperham@mastodon.xyz ](https://mastodon.xyz/@mperham ) / [@sidekiq ](https://twitter.com/sidekiq ), [https://www.mikeperham.com ](https://www.mikeperham.com ) / [https://www.contribsys.com ](https://www.contribsys.com )
