Repo brief: rails/solid_queue

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T13:50:28.833Z · commit 176721e33f54

Verdict

Healthy — Strong maintenance signals

• Last commit 7w ago
• 22+ active contributors
• Distributed ownership (top contributor 39% of recent commits)
• MIT licensed
• 2 more receipts on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

Solid Queue is a database-backed Active Job backend for Ruby on Rails that replaces the default queuing system with a SQL-based implementation. It stores job metadata (executions, schedules, recurring tasks) directly in the database, supporting delayed jobs, concurrency controls, recurring tasks, queue pausing, job priorities, and bulk enqueuing—while leveraging FOR UPDATE SKIP LOCKED for efficient lock-free polling on MySQL/PostgreSQL/SQLite. Modular Rails engine structure: app/models/solid_queue/ contains core domain objects (Execution, Job, RecurringTask, Process, Queue, Semaphore); app/models/solid_queue/execution/ and app/models/solid_queue/job/ use mixins for concerns…

Start here

Open these first:

• lib/solid_queue.rb — Primary entry point and configuration loader for the entire Solid Queue system.
• lib/active_job/queue_adapters/solid_queue_adapter.rb — Active Job adapter that bridges Rails job enqueueing to Solid Queue's database backend.
• app/models/solid_queue/job.rb — Core Job model representing queued work items; all execution states depend on this.
• lib/solid_queue/dispatcher.rb — Dispatcher process that enqueues scheduled/delayed jobs and manages job lifecycle transitions.
• lib/solid_queue/processes/poller.rb — Poller process that claims and executes ready jobs from the database using FOR UPDATE SKIP LOCKED.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/rails/solid_queue.git
cd solid_queue
bundle install
bin/setup
bundle exec rake test

Note: requires Ruby 3.1.6+ and Rails 7.1+; uses Bundler for dependency management.

Daily commands:

Development mode via bin/setup installs dependencies. To use locally: bundle exec rails solid_queue:install in a Rails app, then bin/jobs start (generated by installer) or configure via config/queue.yml. Tests:…

…shortened for this brief.

Key cautions & unknowns

• 1. Database schema: Solid Queue requires db/queue_schema.rb separate from main app schema—migrations don't auto-run on rails db:migrate without configuration. 2) FOR UPDATE SKIP LOCKED not universal:…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.