ActiveJob with Sidekiq on Rails

This article introduces how to install ActiveJob using Sidekiq in Rails.

🏀 Installation

Prepare Redis

Install Redis on macOS by Homebrew:

brew install redis

Install Redis on Linux(CentOS) by yum or etc:

sudo yum install -y redis
sudo service redis start

Edit Gemfile

Add some gem names to Gemfile. After then, please execute bundle install in terminal.

# Job queue
gem 'sidekiq'
gem 'sinatra', require: false
gem 'redis-namespace'

🍣 Configuration

Please edit config/application.rb:

config.active_job.queue_adapter = :sidekiq
Sidekiq.configure_server { |c| c.redis = { url: ENV['REDIS_URL'] } }

Please add & edit config/sidekiq.yml:

:concurrency: 2
:logfile: ./log/sidekiq.log
- default

Please edit routes.rb:

require 'sidekiq/web'

Rails.application.routes.draw do
mount Sidekiq::Web => '/sidekiq'

After then, you can see sidekiq admin page from http://localhost:3000/sidekiq.

😼 How to create class of ActiveJob

rails g job hoge

after then, please edit job file.

class HogeJob < ActiveJob::Base
queue_as :default

def perform(*args)
# Do something later

If you want to call the job function, please write the follow.


🐰 Admin page

Authentication with Devise

If you want to add authentication with Devise, please add config/routes.rb.

# config/routes.rb
authenticate :user do
mount Sidekiq::Web => '/sidekiq'

Basic Authentication

require "sidekiq/web"

Sidekiq::Web.use Rack::Auth::Basic do |username, password|
# Protect against timing attacks:
# - See
# - See
# - Use & (do not use &&) so that it doesn't short circuit.
# - Use digests to stop length information leaking (see also ActiveSupport::SecurityUtils.variable_size_secure_compare)
ActiveSupport::SecurityUtils.secure_compare(::Digest::SHA256.hexdigest(username), ::Digest::SHA256.hexdigest(ENV["SIDEKIQ_USERNAME"])) &
ActiveSupport::SecurityUtils.secure_compare(::Digest::SHA256.hexdigest(password), ::Digest::SHA256.hexdigest(ENV["SIDEKIQ_PASSWORD"]))
end if Rails.env.production?

mount Sidekiq::Web, at: "/sidekiq"

🤔 Execution

You can run a process of sidekiq by as follows:

bundle exec sidekiq -C config/sidekiq.yml

🗽 RSpec

Before you write RSpec for the above job, you should set configuration to spec/rails_helper.rb.

RSpec.configure do |config|
config.include ActiveJob::TestHelper, type: :job
# ...

Now, you can write RSpec for the Job in spec/jobs/example_job_spec.rb like this:

require 'rails_helper'

RSpec.describe ExampleJob, type: :job do
subject(:job) { described_class.perform_later(123) }

it 'queues the job' do
expect { job }
.to change(ActiveJob::Base.queue_adapter.enqueued_jobs, :size).by(1)

it 'is in urgent queue' do
expect( eq('urgent')

it 'executes perform' do
perform_enqueued_jobs { job }
# expect xxxx

it 'handles no results error' do
allow(MyService).to receive(:call).and_raise(NoResultsError)

perform_enqueued_jobs do
.to receive(:retry_job).with(wait: 10.minutes, queue: :default)


after do

🐯 Special Thanks

🖥 Recommended VPS Service

VULTR provides high performance cloud compute environment for you. Vultr has 15 data-centers strategically placed around the globe, you can use a VPS with 512 MB memory for just $ 2.5 / month ($ 0.004 / hour). In addition, Vultr is up to 4 times faster than the competition, so please check it => Check Benchmark Results!!