chore: SMTP is a simple implementation, recommand local server to have a spool

2026-06-02 00:21:34 +02:00
parent 8a05ee00cb
commit 408b084ee6
3 changed files with 39 additions and 0 deletions
@@ -318,6 +318,12 @@ OXICLOUD_WOPI_ENABLED=false
 # Used by the magic-link invitation flow (sharing with someone by email) and
 # the login-via-email flow. When HOST is empty (the default), the feature is
 # disabled and any endpoint that needs email returns 503.
+#
+# OxiCloud does NOT spool mail or retry failed sends — each delivery is a
+# single attempt. For durability against brief upstream outages, point this
+# at a local MTA (Postfix, OpenSMTPD, msmtp-mta, …) configured as a
+# smarthost. The local MTA owns the queue and retries against your real
+# relay. See docs/config/env.md → "Reliability and retries" for the recipe.

 # SMTP server hostname or IP. Empty = feature disabled.
 #OXICLOUD_SMTP_HOST=smtp.example.com