From 86d9ea10d6a0d917db140d0975efb7776d7d8293 Mon Sep 17 00:00:00 2001
From: Federico Scodelaro <federicoscodelaro@gmail.com>
Date: Mon, 23 Mar 2026 15:44:58 -0300
Subject: [PATCH] docs(stalwart): Add alias example

---
 example_configs/stalwart.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/example_configs/stalwart.md b/example_configs/stalwart.md
index 3a6b0e2..f018d63 100644
--- a/example_configs/stalwart.md
+++ b/example_configs/stalwart.md
@@ -48,3 +48,12 @@ To integrate with LLDAP,
       allow-invalid-certs = true
       enable = false
 ```
+
+## Email alias
+If you want to enable [email aliases](https://stalw.art/docs/mta/inbound/rcpt/#catch-all-addresses) you have to create a new *User-defined attribute* under *User schema* of type string. Currently lldap doesnt support multivalue filters, if you want multiple aliases you will have to create multiple values (mailAlias1, mailAlias2, ..., mailAliasN) with N beeing the max aliases an account will have.
+
+You also need to change your ldap filter for emails.
+```toml
+[directory.ldap.filter]
+    email = "(&(objectclass=person)(|(mail=?)(mailAlias1=?)(mailAlias2=?)(mailAliasN=?)))"
+```