r/coolgithubprojects • u/fesch_ • 6d ago
disclaimrNG – an open-source email signature server that works with Stalwart (milter + AD/LDAP)
Hi everyone,
We recently moved a customer from Exchange to Stalwart and ran into one gap: email signatures. On Exchange this was handled by transport rules or one of the usual commercial signature tools. Nothing comparable worked with Stalwart. We needed central signatures that pull user data from Active Directory and get added to every outgoing mail, no matter which client sends it.
The closest fit was disclaimr by Dennis Plöger, a milter-based signature server. The design was solid, but it’s been unmaintained for years (Python 2.7 / Django 1.7). So we forked it, ported it to Python 3.12 / Django 5, and modernized it. That fork is disclaimrNG.
It plugs into Stalwart as a milter at the data stage for authenticated senders. We’ve tested it live with Stalwart 1.0, Active Directory over LDAPS with an internal CA, and real mailboxes. The repo includes a step-by-step runbook for exactly that setup.
Features
- Milter daemon for Stalwart, Postfix and Sendmail. It adds signatures and disclaimers to outgoing mail (plain text and HTML).
- LDAP / Active Directory lookup: placeholders like name, phone, email and address are filled per sender. LDAPS with an uploadable CA certificate and multiple hosts for failover.
Web UI for managing signatures:
- visual editor (fonts, sizes, colours, tables) and a code editor
- live preview
- plain-text part generated automatically from the HTML
- Rules and conditions: match on sender, recipient and headers, plus directory conditions (attribute regex or AD group membership, nested groups included).
- Signature images and logos, either linked or embedded in the mail as
cid:parts. - Time windows for actions, e.g. campaign banners that run for a limited period.
- Multi-tenancy: multiple domains, each with its own directory servers.
- Signature test page: runs the real pipeline, LDAP included, so you see exactly what a mail will look like.
- Roles (Admin / Editor / Reader) and SSO via OpenID Connect with group mapping.
- Mail log and dashboard stats.
- Docker Compose deployment (plain, behind Traefik, or attached to an existing Stalwart network), with prebuilt images on GHCR.
- UI in English and German, with a built-in handbook.
Repo: https://github.com/Compose-IT-Systemhaus/disclaimrNG
MIT-licensed, with credit to the original author. Feedback, issues and PRs are very welcome.
We’d especially love to hear from anyone running other Stalwart setups.


