OptimoCMS Docs
Back to overview

Mail Providers

Connect your own mail provider to webmail: IMAP/SMTP, Google Workspace or Microsoft 365. Including auto-detection, migration and an overview of available features per provider.

Choosing a mail provider

Webmail supports multiple mail providers. Choose the one that suits your situation: • Integrated hosting — the default hosting provider, fully integrated with all features. • IMAP/SMTP (generic) — connect an external mail account via IMAP and SMTP. Works with almost any mail server. • Google Workspace — connect via OAuth to use Gmail directly in webmail. • Microsoft 365 — connect via OAuth for Outlook/Exchange Online. Available features vary by provider. See the 'Available features per provider' section for an overview.
Tips
  • When adding a mailbox, you choose the provider in the configuration panel.
  • You can combine multiple providers on the same site.

Setting up IMAP/SMTP

Connect an external mail account via IMAP (receiving) and SMTP (sending): 1. Go to Site settings → Email → Webmail → Add mailbox. 2. Choose 'IMAP/SMTP' as the provider. 3. Enter the email address — the system will try to automatically detect server settings (auto-discovery). 4. If auto-discovery succeeds, host, port and encryption are filled in automatically. 5. Enter your username and password. 6. Click 'Test connection' to verify everything works. 7. Save. If auto-discovery fails, enter the settings manually: • IMAP server: e.g. imap.provider.com, port 993 (SSL/TLS) • SMTP server: e.g. smtp.provider.com, port 465 (SSL/TLS) or 587 (STARTTLS)
Tips
  • Most providers use port 993 for IMAP and 465 or 587 for SMTP.
  • Auto-discovery works via the Mozilla ISPDB database and DNS records (MX, SRV, autoconfig).
Note
  • Some providers require an app-specific password if you have two-step verification enabled.

Connecting Google Workspace

Connect Google Workspace (Gmail) via OAuth for secure access without a password: 1. Go to Site settings → Email → Webmail → Add mailbox. 2. Choose 'Google Workspace' as the provider. 3. Click 'Sign in with Google'. 4. Log in with your Google account and grant permission. 5. After authorization, the mailbox is automatically configured. The OAuth token is securely stored server-side and automatically refreshed.
Tips
  • Google Workspace offers full functionality: contacts, calendar, labels and more.
  • If you have issues: check if your Google admin has enabled API access.

Connecting Microsoft 365

Connect Microsoft 365 (Outlook/Exchange Online) via OAuth: 1. Go to Site settings → Email → Webmail → Add mailbox. 2. Choose 'Microsoft 365' as the provider. 3. Click 'Sign in with Microsoft'. 4. Log in with your Microsoft account and grant permission. 5. After authorization, the mailbox is automatically configured. The OAuth token is securely stored server-side and automatically refreshed.
Tips
  • Microsoft 365 supports contacts, calendar, rules and aliases.
  • If you have issues: check if your Microsoft 365 admin has set the correct API permissions.

Migrating email

The migration wizard lets you transfer emails from one provider to another: 1. Go to Site settings → Email → Webmail → Migration. 2. Select the source mailbox (where you're migrating from). 3. Select the target mailbox (where you're migrating to). 4. Choose which folders to migrate. 5. Click 'Start migration'. Progress is shown in real time. You can continue using webmail during the migration.
Tips
  • Test with one folder first to verify everything works correctly.
  • Large mailboxes (>10,000 messages) may take several minutes.
Note
  • Messages are copied, not moved. The original mailbox remains intact.

Available features per provider

Not every provider supports the same features. Here's an overview: • Inbox, reading, sending, folders, moving, deleting, flags, attachments — all providers. • Search — all providers (IMAP: basic search). • Threading — Integrated hosting, Google, Microsoft (native). IMAP: via header parsing. • Contacts — Integrated hosting, Google (People API), Microsoft (Graph API). IMAP: not available. • Calendar — Integrated hosting, Google (Calendar API), Microsoft (Graph API). IMAP: not available. • Templates — Integrated hosting only. • Filters — Integrated hosting (native), IMAP (ManageSieve), Google (Gmail filters), Microsoft (Inbox rules). • Identities — Integrated hosting, Google (Send-as), Microsoft (aliases). IMAP: not available. • Scheduled send — Integrated hosting, Google, Microsoft. IMAP: not available. • Auto-reply — Integrated hosting, IMAP (Sieve), Google, Microsoft. Features that are not available for your provider are automatically hidden in the interface.
Tips
  • Integrated hosting offers the most features because it's fully integrated.
  • For IMAP providers, functionality depends on what the server supports.

Troubleshooting connection issues

If you're experiencing connection issues with your mail provider: 1. Check provider status — go to Site settings → Email → Webmail → Provider status to see if there are known issues. 2. Verify your credentials — re-enter your password. Watch for capitals and special characters. 3. Check server settings — verify host, port and encryption method with your provider. 4. App password — if you use two-step verification, you may need an app-specific password. 5. Firewall/network — some networks block IMAP/SMTP ports. Try a different network. 6. Refresh OAuth — for Google/Microsoft: disconnect and reconnect if the token has expired. If the issue persists, contact your hosting provider or IT administrator.
Tips
  • The provider status page shows real-time information about your mail server's reachability.
  • For IMAP servers, port 993 (SSL/TLS) is the most reliable option.

Call us