rsigma config reload

Ask a running daemon to hot-reload its rules, pipelines, enrichers, and TLS material.

Synopsis

rsigma config reload [--addr <ADDR>] [--config <PATH>]

Description

Sends an empty POST /api/v1/reload to the daemon’s HTTP API. The request goes through the daemon’s central debounced reload task, the same path used by SIGHUP on Unix and the file watcher. Cross-platform (works on Windows, where SIGHUP does not exist).

The address comes from --addr or from the daemon.api.addr field of the resolved config. Wildcard bind addresses (0.0.0.0, [::]) are mapped to the corresponding loopback address so the client can connect.

Like engine status, this command does not send an Authorization header. When the daemon has authentication enabled, POST /api/v1/reload requires reload:execute (built-in admin). Grant that via anonymous_permissions, or call the endpoint with an explicit bearer token.

Flags

Flag Default Description
--addr <ADDR> resolved daemon.api.addr host:port or full URL of the daemon API.
-c, --config <PATH> discovery chain Config file used to resolve daemon.api.addr.

Examples

Default: use the address from the config:

rsigma config reload
# reload requested: http://127.0.0.1:9090/api/v1/reload

Override the address:

rsigma config reload --addr daemon.internal:9090

Reload a TLS-protected daemon:

rsigma config reload --addr https://daemon.internal:9443

On Unix, you can also send SIGHUP directly:

kill -HUP $(pgrep -f "rsigma engine daemon")

Exit codes

Code Meaning
0 The daemon accepted the reload request (2xx).
3 The daemon could not be reached, or returned a non-success status (including 401/403 when authentication is required).

See also