rq/docs/patterns/systemd.md

43 lines
1.2 KiB
Markdown

---
title: "Running RQ Workers under systemd"
layout: patterns
---
## Running RQ Workers Under systemd
Systemd is process manager that's built into many popular Linux distributions.
To run multiple workers under systemd, you'll first need to create a unit file.
We can name this file `rqworker@.service`, put this file in `/etc/systemd/system`
directory (location may differ by what distributions you run).
```
[Unit]
Description=RQ Worker Number %i
After=network.target
[Service]
Type=simple
WorkingDirectory=/path/to/working_directory
Environment=LANG=en_US.UTF-8
Environment=LC_ALL=en_US.UTF-8
Environment=LC_LANG=en_US.UTF-8
ExecStart=/path/to/rq worker -c config.py
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID
PrivateTmp=true
Restart=always
[Install]
WantedBy=multi-user.target
```
If your unit file is properly installed, you should be able to start workers by
invoking `systemctl start rqworker@1.service`, `systemctl start rqworker@2.service`
from the terminal.
You can also reload all the workers by invoking `systemctl reload rqworker@*`.
You can read more about systemd and unit files [here](https://www.digitalocean.com/community/tutorials/understanding-systemd-units-and-unit-files).