finds.dev

seuros/capistrano-sidekiq

Sidekiq integration for Capistrano

View on GitHub

★ 561RubyNOASSERTIONupdated Sep 2025

// the take

A Capistrano plugin that installs, starts, and manages Sidekiq as a systemd service during Rails deploys. It's for teams still deploying with Capistrano to bare VMs who need Sidekiq restarted and supervised without reaching for Docker or a process manager like foreman.

Systemd integration is done properly: separate service units per config file, so you can run a critical-queue worker and a low-priority worker as independently restartable services instead of one monolithic process. Shares settings conventions (service_unit_user, systemctl_bin, lingering_user) with sibling gems like capistrano-puma, so a multi-service deploy.rb stays consistent. Deployment tracking hooks into Sidekiq 7's metrics to drop a marker on the graph, which is a genuinely useful correlation tool when a deploy causes a latency spike. Sidekiq Enterprise swarm support (sidekiqswarm) is handled as a first-class mode, not bolted on.

Hard requirement on Sidekiq 7+ and systemd — there's no fallback for monit, upstart, or older Sidekiq, so it's a non-starter if you're not already on that stack. The configuration surface is large (a dozen+ settings, per-server overrides, prefixed overrides of shared settings) and getting service naming and env var merging right across multiple servers takes real trial and error. It inherits Capistrano's SSH-based deploy model, which doesn't fit container or Kubernetes workflows at all, so adopting this is really a bet on staying with traditional VM deploys long-term. No mention of how it handles mid-deploy job loss or in-flight job draining beyond Sidekiq's own graceful shutdown — that's left entirely to Sidekiq's defaults.

We read the README, the directory tree and a key source file in November 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
561
Forks
300
Language
Ruby
License
NOASSERTION
Last commit
2 Sep 2025

// nearby

If capistrano-sidekiq isn't quite it.

All repos →