From e62641a39b26b39d98da913d84fa471ef9b0ae4d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Antoine=20Beaupr=C3=A9?= <anarcat@debian.org>
Date: Mon, 17 Mar 2025 15:44:59 -0400
Subject: [PATCH] email: document other alias mechanisms
---
service/email.md | 21 +++++++++++++++++++++
1 file changed, 21 insertions(+)
diff --git a/service/email.md b/service/email.md
index 2a16e931..f66c5ed9 100644
--- a/service/email.md
+++ b/service/email.md
@@ -651,6 +651,27 @@ postmap -q user@torproject.org ldap:/etc/postfix/maps/transport_local
This should return `smtp:srs.torproject.org`.
+Individual hosts *may* also define aliases with a
+`postfix::profile::alias` define for local, backwards-compatibility
+purposes. This should be considered legacy and typically will not work
+if there is a virtual map override (a common configuration). In that
+case, a local alias may be defined with (say):
+
+```puppet
+ postfix::map { 'virtual':
+ map_dir => $postfix::map_dir,
+ postmap_command => $postfix::postmap_command,
+ owner => $postfix::owner,
+ group => $postfix::group,
+ mode => $postfix::mode,
+ type => 'hash',
+ contents => [
+ 'postmaster@example.torproject.org postmaster@torproject.org',
+ 'do-not-reply@example.torproject.org nobody',
+ ],
+ }
+```
+
### SRS
Our SRS servers, currently only srs-dal-01, are managed by the profile::srs manifest.
--
GitLab