From 7059832ceb0582a67e28a6e008ecb060e0be72e9 Mon Sep 17 00:00:00 2001 From: Phill Coxon Date: Mon, 10 Mar 2025 20:33:59 +1300 Subject: [PATCH] DEV: Update standalone.yml Improve SMTP guidance in the config file Updated the template advising that the sending domain or sub-domain and DISCOURSE_NOTIFICATION_EMAIL address should be authenticated with SMTP providers to ensure email delivery. Also provided a direct link to info on the `discourse-doctor` command that can assist with testing and debugging email configurations. --- samples/standalone.yml | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/samples/standalone.yml b/samples/standalone.yml index e6d946f03..83552b760 100644 --- a/samples/standalone.yml +++ b/samples/standalone.yml @@ -61,6 +61,15 @@ env: DISCOURSE_DEVELOPER_EMAILS: 'me@example.com,you@example.com' ## TODO: The SMTP mail server used to validate new accounts and send notifications + # + # Most SMTP providers will require an authenticated domain or authenticated email + # address to send emails. Please ensure you have authenticated your sending domain + # (example.com) or sub-domain (discourse.example.com), and the DISCOURSE_NOTIFICATION_EMAIL + # address with your SMTP provider before registering new users to ensure email deliverability. + # + # The `discourse-doctor` command can assist with testing your email configuration. + # See: https://meta.discourse.org/t/troubleshoot-email-on-a-new-discourse-install + # # SMTP ADDRESS, username, and password are required # WARNING the char '#' in SMTP password can cause problems! DISCOURSE_SMTP_ADDRESS: smtp.example.com