    Skip to content

      Navigation Menu

            Sign in Appearance settings
                * Platform
                        + AI CODE CREATION
                            o GitHub Copilot Write better code with AI
                            o GitHub Copilot app Direct agents from issue to merge
                            o MCP Registry Integrate external tools
                        + DEVELOPER WORKFLOWS
                            o Actions Automate any workflow
                            o Codespaces Instant dev environments
                            o Issues Plan and track work
                            o Code Review Manage code changes
                            o Code Quality Enforce quality at merge
                        + APPLICATION SECURITY
                            o GitHub Advanced Security Find and fix vulnerabilities
                            o Code security Secure your code as you build
                            o Secret protection Stop leaks before they start
                        + EXPLORE
                            o Why GitHub
                            o Documentation
                            o Blog
                            o Changelog
                            o Marketplace
                      View all features
                * Solutions
                        + BY COMPANY SIZE
                            o Enterprises
                            o Small and medium teams
                            o Startups
                            o Nonprofits
                        + BY USE CASE
                            o App Modernization
                            o DevSecOps
                            o DevOps
                            o CI/CD
                            o View all use cases
                        + BY INDUSTRY
                            o Healthcare
                            o Financial services
                            o Manufacturing
                            o Government
                            o View all industries
                      View all solutions
                * Resources
                        + EXPLORE BY TOPIC
                            o AI
                            o Software Development
                            o DevOps
                            o Security
                            o View all topics
                        + EXPLORE BY TYPE
                            o Customer stories
                            o Events & webinars
                            o Ebooks & reports
                            o Business insights
                            o GitHub Skills
                        + SUPPORT & SERVICES
                            o Documentation
                            o Customer support
                            o Community forum
                            o Trust center
                            o Partners
                      View all resources
                * Open Source
                        + COMMUNITY
                            o GitHub Sponsors Fund open source developers
                        + PROGRAMS
                            o Security Lab
                            o Maintainer Community
                            o Accelerator
                            o GitHub Stars
                            o Archive Program
                        + REPOSITORIES
                            o Topics
                            o Trending
                            o Collections
                * Enterprise
                        + ENTERPRISE SOLUTIONS
                            o Enterprise platform AI-powered developer platform
                        + AVAILABLE ADD-ONS
                            o GitHub Advanced Security Enterprise-grade security features
                            o Copilot for Business Enterprise-grade AI features
                            o Premium Support Enterprise-grade 24/7 support
              * Pricing
                Type / to search
                Sign in
              Sign up Appearance settings
      You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert

              Uh oh!

              There was an error while loading. Please reload this page.

              sidekiq / sidekiq Public
              * Notifications You must be signed in to change notification settings
              * Fork 2.5k
                * Star 13.6k
          * Code
          * Issues 17
          * Pull requests 3
          * Discussions
          * Actions
          * Wiki
          * Security and quality 1
          * Insights
          Additional navigation options
                  * Code
                  * Issues
                  * Pull requests
                  * Discussions
                  * Actions
                  * Wiki
                  * Security and quality
                  * Insights
                                              main
                                          Branches Tags
                                            Go to file
                                        Code
                                          Open more actions menu

                                        Folders and files

                                          Name                      Name                        Last commit message    Last commit date
                                            Latest commit         
                                                                  
                                                History           
                                                                  
                                                5,400 Commits     
                                                  5,400 Commits   
                                                  .github                   .github                                                    
                                                  bare                      bare                                                       
                                                  bin                       bin                                                        
                                                  docs                      docs                                                       
                                                  examples                  examples                                                   
                                                  lib                       lib                                                        
                                                  myapp                     myapp                                                      
                                                  test                      test                                                       
                                                  web                       web                                                        
                                                  .gitattributes            .gitattributes                                             
                                                  .gitignore                .gitignore                                                 
                                                  .standard.yml             .standard.yml                                              
                                                  .yardopts                 .yardopts                                                  
                                                  COMM-LICENSE.txt          COMM-LICENSE.txt                                           
                                                  Changes.md                Changes.md                                                 
                                                  Ent-Changes.md            Ent-Changes.md                                             
                                                  Gemfile                   Gemfile                                                    
                                                  LICENSE.txt               LICENSE.txt                                                
                                                  Pro-Changes.md            Pro-Changes.md                                             
                                                  README.md                 README.md                                                  
                                                  Rakefile                  Rakefile                                                   
                                                  sidekiq.gemspec           sidekiq.gemspec                                            
                                            View all files        
                                          

                                              Repository files navigation

                                                * 
                                                * README
                                                * Code of conduct
                                                * Contributing
                                                * License
                                                * Security
                                                More items

                                                Sidekiq

                                              Simple, efficient background jobs for Ruby.

                                              Sidekiq uses threads to handle many jobs at the same time in the same process. Sidekiq can be used by any Ruby application.

                                                Requirements

                                                * Redis: Redis 7.0+, Valkey 7.2+ or Dragonfly 1.27+
                                                * Ruby: MRI 3.2+ or JRuby 9.4+.

                                              Sidekiq 8.0 supports Rails and Active Job 7.0+.

                                              Sidekiq supports Valkey and Dragonfly as Redis alternatives. Redis 7.2.4 is considered to be the canonical implementation. Incompatibilities with that version are considered bugs.

                                                Installation

                                                bundle add sidekiq

                                                Getting Started

                                              See the Getting Started wiki page and follow the simple setup process. You can watch this YouTube playlist to learn all about Sidekiq and see its features in action. Here's the Web UI:

                                                Performance

                                              The benchmark in bin/sidekiqload creates 500,000 no-op jobs and drains them as fast as possible, assuming a fixed Redis network latency of 1ms. This requires a lot of Redis network I/O and JSON parsing. This benchmark is IO-bound so we increase the concurrency to 25. If your application is sending lots of emails or performing other network-intensive work, you could see a similar benefit but be careful not to saturate the CPU. Real world applications will rarely if ever need to use concurrency greater than 10.

                                              Version        Time to process 500k jobs  Throughput (jobs/sec)  Ruby        Concurrency  Job Type       
                                              Sidekiq 7.0.3  21.3 sec                   23,500                 3.2.0+yjit  30           Sidekiq::Job   
                                              Sidekiq 7.0.3  33.8 sec                   14,700                 3.2.0+yjit  30           ActiveJob 7.0.4
                                              Sidekiq 7.0.3  23.5 sec                   21,300                 3.2.0       30           Sidekiq::Job   
                                              Sidekiq 7.0.3  46.5 sec                   10,700                 3.2.0       30           ActiveJob 7.0.4
                                              Sidekiq 7.0.3  23.0 sec                   21,700                 2.7.5       30           Sidekiq::Job   
                                              Sidekiq 7.0.3  46.5 sec                   10,850                 2.7.5       30           ActiveJob 7.0.4
                                              

                                              Most of Sidekiq's overhead is Redis network I/O. ActiveJob adds a notable amount of CPU overhead due to argument deserialization and callbacks. Concurrency of 30 was determined experimentally to maximize one CPU without saturating it.

                                                Want to Upgrade?

                                              Use bundle up sidekiq to upgrade Sidekiq and all its dependencies. Upgrade notes between each major version can be found in the docs/ directory.

                                              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 quality open source development all at the same time. Please see the Sidekiq homepage for more detail.

                                                Problems?

                                              Do not directly email any Sidekiq committers with questions or problems. A community is best served when discussions are held in public.

                                              If you have a problem, please review the FAQ and Troubleshooting wiki pages. Searching the issues for your problem is also a good idea.

                                              Sidekiq Pro and Sidekiq Enterprise customers get private email support. You can purchase at https://sidekiq.org; email support@contribsys.com for help.

                                              Useful resources:

                                                * Product documentation is in the wiki.
                                                * Occasional announcements are made to the @sidekiq Mastodon account.
                                                * The Sidekiq tag on Stack Overflow has lots of useful Q & A.
                                                * Join us in the sidekiq tag on the Ruby Users Forum.

                                              Every Thursday morning is Sidekiq Office Hour: I video chat and answer questions. See the Sidekiq support page for details.

                                                Contributing

                                              See the contributing guidelines.

                                                ERB Linting with HERB

                                              This project uses HERB for ERB file linting and formatting. All ERB files have been renamed to use the .html.erb extension for better tooling support.

                                              Local Development:

                                                # Run HERB linting
                                                bundle exec rake lint:herb
                                                 # or
                                                bin/lint-herb

                                              CI Integration: HERB linting is automatically run in CI to ensure all ERB files are properly formatted and free of parse errors.

                                                License

                                              See LICENSE.txt for licensing details. The license for Sidekiq Pro and Sidekiq Enterprise can be found in COMM-LICENSE.txt.

                                                Author

                                              Mike Perham, mastodon, https://www.mikeperham.com / https://www.contribsys.com

                                        About

                                        Simple, efficient background processing for Ruby

                                          sidekiq.org

                                        Topics

                                          background-jobsjobsrubysidekiq

                                        Resources

                                          Readme
                                          License

                                        Code of conduct

                                          Code of conduct

                                        Contributing

                                          Contributing

                                        Security policy

                                          Security policy
                                          Activity
                                          Custom properties

                                        Stars

                                          13.6k stars

                                        Watchers

                                          203 watching

                                        Forks

                                          2.5k forks
                                          Report repository

                                        Releases

                                        Packages

                                        Used by

                                        Contributors

                                        Languages

    Footer

        © 2026 GitHub, Inc.

      Footer navigation

        * Terms
        * Privacy
        * Security
        * Status
        * Community
        * Docs
        * Contact
        * Manage cookies
        * Do not share my personal information
      You can’t perform that action at this time.