Skip to content
Documentation navigation

Queue operations

k0smos ships the logical queues default and notifications. The transport can be Doctrine DBAL or Redis with DBAL failover; changing transport does not change the required worker topology.

Inspect topology

php bin/console queue:topology --host=k0smos.example.com

The command reports producers, effective queue names, expected tenant.queue.slot worker identifiers, and heartbeats. It is read-only and is the first diagnostic to run.

Start workers

Run one supervised process for every slot reported by queue:topology. Keep the tenant host and queue explicit in the service configuration, and use the examples shipped under doc/example/systemd/ as deployment references.

Failure behavior

When Redis is selected but unavailable, supported queue operations fall back to DBAL. Investigate warnings and restore Redis; do not assume failover removes the need for monitoring.

Canonical reference

The complete operator contract remains in the repository file doc/Queues.md. This public page is a curated operational entry point, not a competing topology specification.