---
title: 'Pyzor Settings'
url: 'https://docs.danami.com/warden/settings/antispam/plugin-settings/pyzor'
markdown: 'https://docs.danami.com/warden/settings/antispam/plugin-settings/pyzor.md'
date: '2026-10-09'
description: 'Use pyzor - use_pyzor Whether to use Pyzor, if it is available. Default: 1 Pyzor fork - pyzor_fork Instead of running Pyzor synchronously, fork separate process for it and read the results in later (similar to async DNS lookups). Increases throughput. Default: 0 Pyzor count min - pyzor_count_min Th…'
taxonomy:
  category:
    - docs
  tag:
    - pyzor
---

[](#)  [ Basics ](https://docs.danami.com/warden/)     [ Settings ](https://docs.danami.com/warden/settings)     [ Antispam ](https://docs.danami.com/warden/settings/antispam)     [ Plugin Settings ](https://docs.danami.com/warden/settings/antispam/plugin-settings)      Pyzor Settings    

# Pyzor Settings

**Use pyzor** - `use_pyzor`
Whether to use Pyzor, if it is available.
Default: 1

**Pyzor fork** - `pyzor_fork`
Instead of running Pyzor synchronously, fork separate process for it and read the results in later (similar to async DNS lookups). Increases throughput.
Default: 0

**Pyzor count min** - `pyzor_count_min`
This option sets how often a messages body checksum must have been reported to the Pyzor server before SpamAssassin will consider the Pyzor check as matched.
Default: 10

**Pyzor welcomelist min** - `pyzor_welcomelist_min`
This option sets how often a messages body checksum must have been whitelisted to the Pyzor server for SpamAssassin to consider ignoring the result. Final decision is made by pyzor\_welcomelist\_factor.
Default: 10

**Pyzor welcomelist factor** - `pyzor_welcomelist_factor`
Ignore Pyzor result if REPORTCOUNT x NUMBER >= `pyzor_welcomelist_min`. For default setting this means: 50 reports requires 10 whitelistings.
Default: 0.2

**Pyzor timeout** - `pyzor_timeout`
How many seconds you wait for Pyzor to complete, before scanning continues without the Pyzor results. A numeric value is optionally suffixed by a time unit (s, m, h, d, w, indicating seconds (default), minutes, hours, days, weeks).
Default: 10

**Pyzor max** - `pyzor_max`
This option sets how often a messages body checksum must have been reported to the Pyzor server before SpamAssassin will consider the Pyzor check as matched. As most clients should not be auto-reporting these checksums, you should set this to a relatively low value, e.g. 5.
Default: 5

**Pyzor path** - `pyzor_path`
The full path to the pyzor binary.
Default: /usr/bin/pyzor

**Pyzor options** - `pyzor_options`
Specify additional options to the pyzor command. Please note that only characters in the range \[0-9A-Za-z ,.\_/-\] are allowed for security reasons.
Default: --homedir /etc/mail/spamassassin/.pyzor

## Related Pages

- [Pyzor](https://docs.danami.com/warden/user-guide/antispam-plugins/pyzor "Pyzor")

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

---

## Navigation

- Parent: [Plugin Settings](https://docs.danami.com/warden/settings/antispam/plugin-settings.md)
- Previous: [Phishing Settings](https://docs.danami.com/warden/settings/antispam/plugin-settings/phishing.md)
- Next: [Razor2 Settings](https://docs.danami.com/warden/settings/antispam/plugin-settings/razor2.md)