Reset spam-filter training

Reset learning when training is unsuitable or poisoned, or when a drastic change in spam patterns calls for fresh learning. This is separate from removing a sender block.

Permanent training-data deletion

Reset clears Redis database 0. Confirm that database’s ownership first: the operation can affect more than a single mail-policy entry. Saving a block/trust list does not back up learned data.

1. Open Spam AutoShield → Settings.
2. Check Apply actions to and the exact servers.
3. Choose Reset training data, read the confirmation, and run it only when that reset is intended.
4. Wait for each final result. Plan new training and monitor filtering afterwards.

For dataset training, follow Train spam filter. Canceling later training does not erase learning already applied.

Command-line method

From a root terminal on the intended mail server, run:

cpfence --reset-rspamd-training-data

The command asks whether to permanently delete Redis database 0. Confirm its ownership and arrange a usable Redis backup first if recovery is required. Answer y or yes only when this server’s complete reset is intended; press Enter or answer N to cancel.

Read the final output. A Redis or authentication error is not a completed reset; review the cause before trying again. The command acts on this server, not the WebUI’s Apply actions to selection.

Allow time for new learning

Let affected customers know that filtering may be less accurate until retraining rebuilds useful learning. Monitor mail classification afterwards. Restoring block/trust lists cannot restore the deleted training data.