SideBro is a Rack-mountable Sidekiq Web UI alternative with a customizable design. Drop it into Rails or any Rack app for a cleaner, modern dashboard to inspect queues, jobs, and retries.

Features

• Rack-first — mount in Rails routes or run standalone from config.ru
• Customizable UI — refreshed design compared to the default Sidekiq Web interface
• Flexible auth — no built-in authentication; wrap with HTTP Basic, Devise, or any Rack middleware
• Stable sessions — set SIDE_BRO_SESSION_SECRET for consistent session secrets across restarts

Installation

Add gem "side_bro" to your Gemfile and mount the web app:

require "side_bro"
mount SideBro::Web, at: "/side_bro"

For plain Rack, require SideBro and run SideBro::Web from your config.ru.

Authentication examples

Protect SideBro with HTTP Basic auth:

SideBro::Web.use Rack::Auth::Basic, "SideBro" do |user, password|
  [user, password] == ["admin", ENV["SIDE_BRO_PASSWORD"]]
end

In Rails with Devise, mount inside an authenticated admin constraint so only authorized users can access the dashboard.

Part of the Bro family

SideBro complements DeadBro (Rails APM) and SolidBro (Solid Queue UI)—all maintained by Ruby Dev.

View on GitHub RubyGems