---
name: "rqworker"
section: "1"
platform: "linux"
package: "python3-rq"
version: "2.3.3-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/rqworker"
---

# rqworker(1)

Command line monitor to start an RQ worker.

## NAME

rqworker - Command line monitor to start an RQ worker.

## SYNOPSIS

**rqworker \[*OPTIONS*\] \[*QUEUES*\]...**

## DESCRIPTION

-

  rqworker is a command-line monitor to start an RQ worker. It is part of python-rq module package. A worker is a Python process that typically runs in the background and exists solely as a work horse to perform lengthy or blocking tasks that you don’t want to perform inside web processes.

## OPTIONS

- **-b**, **--burst**

  Run in burst mode (quit after all work is done)

- **--logging\_level** *TEXT*

  Set logging level

- **--log-format** *TEXT*

  Set the format of the logs

- **--date-format** *TEXT*

  Set the date format of the logs

- **-n, --name** *TEXT*

  Specify a different name

- **--results-ttl** *INTEGER*

  Default results timeout to be used

- **--worker-ttl** *INTEGER*

  Default worker timeout to be used

- **--maintenance-interval-ttl** *INTEGER*

  Maintenance task interval (in seconds) to be used

- **--job-monitoring-interval** *INTEGER*

  Default job monitoring interval to be used

- **--disable-job-desc-logging**

  Turn off description logging.

- **-v, --verbose**

  Show more output

- **-q, --quiet**

  Show less output

- **--sentry-ca-certs** *TEXT*

  Path to CRT file for Sentry DSN

- **--sentry-debug** *TEXT*

  Enable debug

- **--sentry-dsn** *TEXT***R**

  **Report exceptions to this Sentry DSN**

- **--exception-handler** *TEXT*

  Exception handler(s) to use

- **--pid** *TEXT*

  Write the process ID number to a file at the specified path

- **-d, --disable-default-exception-handler**

  Disable RQ's default exception handler

- **--max-jobs** *INTEGER*

  Maximum number of jobs to execute

- **--max-idle-time** *INTEGER*

  Maximum seconds to stay alive without jobs to execute

- **-s, --with-scheduler**

  Run worker with scheduler

- **-S, --serializer** *TEXT*

  Run worker with custom serializer

- **-ds, --dequeue-strategy** *TEXT*

  Sets a custom stratey to dequeue from multiple queues

- **-S, --serializer** *TEXT*

  Path to serializer, defaults to rq.serializers.DefaultSerializer

- **-P, --path** *TEXT*

  Specify the import path.

- **--connection-class** *TEXT*

  Redis client class to use

- **--queue-class** *TEXT*

  RQ Queue class to use

- **-j, --job-class** *TEXT*RQ Job class to use

  - **-w, --worker-class** *TEXT*

  RQ Worker class to use

- **-c, --config** *TEXT*

  Module containing RQ settings.

- **-u, --url** *TEXT*

  URL describing Redis connection details.

- **--help**

  Show help message and exit.

## SEE ALSO

**[rq(1)](/rq/1.md),** **[rqinfo(1)](/rqinfo/1.md),**\
 Full rq documentation ⟨https://python-rq.org/docs/⟩