---
title: 'antispam:plugin:razor2'
url: 'https://docs.danami.com/warden/command-line-interface/antispam/antispam-plugin-razor2'
markdown: 'https://docs.danami.com/warden/command-line-interface/antispam/antispam-plugin-razor2.md'
date: '2026-10-07'
description: 'A distributed, collaborative, spam detection and filtering network based on user submissions of spam. warden --task=antispam:plugin:razor2 Option Value Default Description --use_razor2 <1|0> 1 Whether to use Razor2, if it is available. --razor_fork <1|0> 0 Instead of …'
taxonomy:
  category:
    - docs
  tag:
    - razor2
---

[](#)  [ Basics ](https://docs.danami.com/warden/)     [ Command Line Interface ](https://docs.danami.com/warden/command-line-interface)      Antispam       antispam:plugin:razor2    

# antispam:plugin:razor2

A distributed, collaborative, spam detection and filtering network based on user submissions of spam.

```
warden --task=antispam:plugin:razor2
```

| Option | Value | Default | Description |
|---|---|---|---|
| `--use_razor2` | <1\|0> | 1 | Whether to use Razor2, if it is available. |
| `--razor_fork` | <1\|0> | 0 | Instead of running Razor2 synchronously, fork separate process for it and read the results in later (similar to async DNS lookups). Increases throughput. (SA 4.0+) |
| `--razor_timeout` | <digit> | 5 | How many seconds you wait for Razor to complete before you go on without the results. |
| `--razor_config` | <string> | /etc/mail/spamassassin/.razor/razor-agent.conf | Full path to the razor configuration file. Please note that only characters in the range \[0-9A-Za-z ,.\_/-\] are allowed for security reasons. |
| `--default` | <yes> |  | Reset all settings to their default values. |
| `--default_option` | <option> |  | Reset a specific setting to its default value. |
| `--reload` | <yes> |  | Reload the service after saving settings. |

## Examples

```
// set the razor_timeout
warden --task=antispam:plugin:razor2 --razor_timeout=10 --reload=yes

// reset razor_timeout to its default value
warden --task=antispam:plugin:razor2 --default_option=razor_timeout --reload=yes

// reset all settings to their default values
warden --task=antispam:plugin:razor2 --default=yes --reload=yes

// increase throughput by running Razor2 in a forked process
warden --task=antispam:plugin:razor2 --razor_fork=1 --razor_timeout=10 --reload=yes
```

## Related Pages

- [Razor2 Settings](https://docs.danami.com/warden/settings/antispam/plugin-settings/razor2 "Razor2 Settings")
- [Razor2](https://docs.danami.com/warden/user-guide/antispam-plugins/razor2 "Razor2")

 [ ](https://docs.danami.com/warden/user-guide/antispam-plugins/razor2) [](https://docs.danami.com/warden/settings/antispam/plugin-settings/razor2)

---

## Navigation

- Previous: [antispam:plugin:pyzor](https://docs.danami.com/warden/command-line-interface/antispam/antispam-plugin-pyzor.md)
- Next: [antispam:plugin:redirectors](https://docs.danami.com/warden/command-line-interface/antispam/antispam-plugin-redirectors.md)