FILTER-RSPAMD(8)

📦 version 0.1.8, in alpine 3.24

🦋 FILTER-RSPAMD(8) — like, the Rspamd filter for OpenSMTPD, bestie 🦋

okay so real quick, the vibes up top: this is FILTER-RSPAMD(8) from the System Manager's Manual, and it's giving very much "small tool, big job" energy. come sit with me, I got you 💖

✨ NAME ✨

filter-rspamd — the Rspamd filter for OpenSMTPD, no cap 🎀

🌸 SYNOPSIS 🌸

filter-rspamd [-url url]

💅 DESCRIPTION 💅

so the filter-rspamd filter for the OpenSMTPD server — that's smtpd(8), iykyk — runs your sessions through an rspamd daemon. that's the whole personality. it filters. it slays.

here's the one and only option, bestie:

  • -url url — connects to the remote rspamd instance living at url. this flag is optional, she's lowkey chill. if you don't specify it, filter-rspamd will just connect to the rspamd instance at http://localhost:11333. default behavior, iconic, we love a sensible fallback 🫶
and listen — all the other rspamd-related configuration? thresholds, enabled modules, all of it? that has to be done in rspamd itself. not here. this filter is not the place. periodt 💀

⭐ EXIT STATUS ⭐

filter-rspamd exits 0 on success, and >0 if an error occurs. that's it. that's the vibe check.

🌈 EXAMPLES 🌈

okay so if you drop this into smtpd.conf, filter-rspamd is enabled for all incoming connections. in this config, you're using the local rspamd daemon:

filter "rspamd" proc-exec "filter-rspamd"

listen on all filter "rspamd"

and this one? this enables filter-rspamd for all incoming connections using a remote rspamd daemon. remote bestie energy 🧚

filter "rspamd" proc-exec "filter-rspamd -url http://example.org:11333"

listen on all filter "rspamd"

👑 SEE ALSO 👑

smtpd.conf(5), rspamd(8) — go read those too, they're literally right there 💜

🍓 AUTHORS 🍓

filter-rspamd is Copyright © 2019 Gilles Chehade <gilles@poolp.org>. this man page is Copyright © 2020 Ryan Kavanagh <rak@debian.org>. both are distributed under the ISC license. respect the authors, they ate 🔥

🙈 BUGS 🙈

None known. genuinely. not me being surprised — she's just built different ✨

okay that's the whole page, you're so welcome 💖 this was written from the Debian edition dated April 24, 2020 — mwah, go filter some mail, bestie 🎀

📦 where this page comes from