# pgbus

> PostgreSQL-native job processing and event bus for Rails, built on PGMQ — ActiveJob adapter, topic-routed events, worker recycling, SSE streams. One database, no Redis.

## Getting started
- [Overview](https://pgbus.zoolutions.llc/docs/overview.md)
- [Installation](https://pgbus.zoolutions.llc/docs/installation.md)
- [Quick start](https://pgbus.zoolutions.llc/docs/quick-start.md)
- [Configuration](https://pgbus.zoolutions.llc/docs/configuration.md)

## Guide
- [Architecture](https://pgbus.zoolutions.llc/docs/architecture.md)
- [ActiveJob adapter](https://pgbus.zoolutions.llc/docs/active-job.md)
- [Event bus](https://pgbus.zoolutions.llc/docs/event-bus.md)
- [Retries & dead letters](https://pgbus.zoolutions.llc/docs/retries-dead-letters.md)
- [Concurrency & uniqueness](https://pgbus.zoolutions.llc/docs/concurrency-uniqueness.md)
- [Routing & ordering](https://pgbus.zoolutions.llc/docs/routing-ordering.md)
- [Batches](https://pgbus.zoolutions.llc/docs/batches.md)
- [Recurring tasks](https://pgbus.zoolutions.llc/docs/recurring-tasks.md)
- [Transactional outbox](https://pgbus.zoolutions.llc/docs/outbox.md)
- [Real-time streams](https://pgbus.zoolutions.llc/docs/streams.md)

## Operations
- [Running workers](https://pgbus.zoolutions.llc/docs/running-workers.md)
- [Dashboard](https://pgbus.zoolutions.llc/docs/dashboard.md)
- [Observability](https://pgbus.zoolutions.llc/docs/observability.md)
- [Performance & tuning](https://pgbus.zoolutions.llc/docs/performance-tuning.md)
- [Separate database](https://pgbus.zoolutions.llc/docs/separate-database.md)
- [Rolling restarts](https://pgbus.zoolutions.llc/docs/rolling-restarts.md)

## Testing
- [Testing](https://pgbus.zoolutions.llc/docs/testing.md)

## Migrate
- [Upgrading pgbus](https://pgbus.zoolutions.llc/docs/upgrading-pgbus.md)
- [From Sidekiq](https://pgbus.zoolutions.llc/docs/from-sidekiq.md)
- [From SolidQueue](https://pgbus.zoolutions.llc/docs/from-solid-queue.md)
- [From GoodJob](https://pgbus.zoolutions.llc/docs/from-good-job.md)

## Reference
- [Configuration reference](https://pgbus.zoolutions.llc/docs/configuration-reference.md)
- [CLI & generators](https://pgbus.zoolutions.llc/docs/cli-generators.md)

## MCP
This documentation is also available over the Model Context Protocol (search, page retrieval) at https://pgbus.zoolutions.llc/mcp — add it to an MCP client (Claude Code, Claude.ai, Cursor) to query these docs as tools.