rspamadm(1)

rspamadm1

Rspamd administration utility

Usage

rspamadm [global_options] [command] [command_options] ...

Overview

rspamadm is a routine to manage rspamd spam filtering system. It is intended to perform such actions as merging databases, performing configuration tests, encrypting passwords, signing configurations and so on. You can get a list of available commands by running

rspamadm -l

Also for each command you can check list of available command_options by running

rspamadm help command
rspamadm command --help

Options

-h, --help

Show help message

-v, --verbose

Enable verbose output

-l, --list-commands

List available commands

--version

Show version

--var=value

Redefine ucl variable in format VARIABLE=VALUE

Return value

On exit rspamadm returns 0 if operation was successful and an error code otherwise.

Examples

Get help for pw command:

rspamadm help pw
rspamadm pw --help

Encrypt controller’s password:

rspamadm pw encrypt

Merge fuzzy databases:

rspamadm fuzzy_merge -s data1.sqlite -s data2.sqlite -t dest.sqlite

Perform configuration test:

rspamadm configtest -c rspamd.conf

Test configuration strictly and redefine some ucl vars:

rspamadm --var=DBDIR=/tmp configtest -c ./rspamd.conf -s

Dump the processed configuration:

rspamadm configdump

Dump the processed configuration as JSON string:

rspamadm configdump -j

Generate a keypair to use for HTTPCrypt encryption:

rspamadm keypair

Releases

5 releases since Debian 10 (Buster); the text changed 1 time.

  1. 10–12
  2. 13–Arch

From rspamd 4.2.3-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.