RZ Ruzor Docs

Mail-flow examples

Integrations

Rust-native Pyzor-compatible client and server documentation.

Use In Mail Pipelines

Ruzor is a command-line tool, so it can be inserted into mail filters that can pipe full message content to a command and make a decision from the exit status.

Test integrations against a private ruzord first. Do not send test report or whitelist traffic to a public service.

Procmail Pattern

ruzor check returns success when a digest is reported above the configured threshold and not whitelisted above the whitelist threshold.

:0 Wc
| ruzor check

:0 e
$DEFAULT

:0
spam-folder

Public Ruzor Endpoint

mkdir -p ~/.ruzor
printf '%s\n' public.ruzor.org:24441 > ~/.ruzor/servers
ruzor ping
ruzor check < message.eml

Batching By Digest

When another system already computed or stored Pyzor digests, use -s digests to skip message parsing.

ruzor -s digests check < digests.txt
ruzor -s digests report < confirmed-spam-digests.txt

ReadyExec Note

Upstream Pyzor documents ReadyExec as a way to reduce Python startup overhead. Ruzor is a native binary and normally does not need that wrapper for startup reasons.