docs(email): fix webmail-reachability note and SMTP port guidance #5

Merged
jknapp merged 2 commits from docs/email-port-webmail-fixes into main 2026-06-23 22:15:01 +00:00
Showing only changes of commit 3b31acbbac - Show all commits
@@ -82,12 +82,14 @@ IMAP (incoming)
SMTP (outgoing) SMTP (outgoing)
Host: <see Setup Instructions> Host: <see Setup Instructions>
Port: 587 Port: 465
Security: STARTTLS Security: SSL/TLS
Username: full email address Username: full email address
Password: same as IMAP Password: same as IMAP
``` ```
For outgoing mail, **port 465 with SSL/TLS** is the standard. If your client prefers STARTTLS, **port 587** is the alternate submission port. (Don't use port 25 from a mail client — it's for server-to-server delivery and most networks block it.)
For per-client walkthroughs (Outlook, Apple Mail, Thunderbird, etc.), see the Email clients section — coming soon. For per-client walkthroughs (Outlook, Apple Mail, Thunderbird, etc.), see the Email clients section — coming soon.
## Webmail ## Webmail
@@ -104,11 +106,11 @@ Send yourself a test message from another account (your personal Gmail, for exam
## Troubleshooting ## Troubleshooting
**Webmail isn't reachable.** DNS for the mail subdomain may still be propagating — wait an hour and try again. **Webmail isn't reachable.** Webmail is hosted at our address — the **Webmail** button on the Email page opens it directly — so it doesn't depend on your domain or its DNS. If it doesn't load, it's almost always a temporary connection issue: try again in a few minutes or from another network, and open a support ticket if it persists.
**Outgoing mail is bouncing or going to spam.** Check the SPF and DKIM records. The **DKIM Management** section on the **Email Domains (DNS)** tab shows whether DKIM is configured for each of your domains. **Outgoing mail is bouncing or going to spam.** Check the SPF and DKIM records. The **DKIM Management** section on the **Email Domains (DNS)** tab shows whether DKIM is configured for each of your domains.
**Client can connect on IMAP but not SMTP.** Some ISPs and corporate networks block outgoing port 587. Try sending from a different network to confirm; if the issue is your network, your ISP is the place to ask. **Client can connect on IMAP but not SMTP.** Some ISPs and corporate networks block outgoing mail ports. If sending fails on port 465, try the alternate submission port **587** (STARTTLS); if both fail, test from a different network to confirm it's your network, and if so, your ISP is the place to ask.
## Related ## Related