Redirecting...
This page has moved to https://docs.nats.io.
Click here if you are not redirected.
Process Signaling
On Unix systems, the NATS server responds to the following signals:
| Signal | Result |
|---|---|
SIGKILL |
Kills the process immediately |
SIGINT |
Stops the server gracefully |
SIGUSR1 |
Reopens the log file for log rotation |
SIGHUP |
Reloads server configuration file |
SIGUSR2 |
Stops the server after evicting all clients (lame duck mode) |
The nats-server binary can be used to send these signals to running NATS servers using the -sl flag:
# Quit the server
nats-server --signal quit
# Stop the server
nats-server --signal stop
# Reopen log file for log rotation
nats-server --signal reopen
# Reload server configuration
nats-server --signal reload
# Lame duck mode server configuration
nats-server --signal ldm
If there are multiple nats-server processes running, or if pgrep isn't available, you must either specify a PID or the absolute path to a PID file:
nats-server --signal stop=<pid>
nats-server --signal stop=/path/to/pidfile
See the Windows Service section for information on signaling the NATS server on Windows.