Docs / Obsidian Mail Server / Apps and devices
Connecting phones, Macs and apps
People can use mail, calendar and contacts in three ways:
- As an Exchange account on iPhone, iPad, Android and Mac: mail, calendar and contacts, all kept in sync, with push. Recommended.
- As an IMAP account in any mail app (Thunderbird, Outlook for Windows, Apple Mail): mail only.
- In the browser with webmail at
https://mail.example.com/mail: mail, calendar and contacts. See Webmail.
For automatic setup to work, the domain needs its autodiscover record (see DNS) and the server a trusted certificate (see Certificates). Without a trusted certificate, phones warn about it and some apps refuse to connect.
Settings for any phone
When an app asks for details, these are all it needs:
| Setting | Value |
|---|---|
| Account type | Exchange / Microsoft Exchange ActiveSync |
| Email address | the person's address, for example [email protected] |
| Server | mail.example.com |
| Username | the full email address |
| Domain | empty |
| Password | the person's normal password |
| Port / security | 443, SSL/TLS on, accept all certificates off |
When a domain is also in a Microsoft 365 tenant (see Outlook and Microsoft 365), the iPhone's Sign In button and the Gmail app's Exchange and Microsoft 365 can open a Microsoft sign-in page. That page leads to Microsoft 365, not to this server: go back and choose Configure Manually / manual setup, then enter the settings above. The Get started page tells you when one of your domains is in such a tenant.
The Outlook app for iPhone and Android does not connect to the server itself: it syncs through Microsoft's cloud service, and for a domain in a Microsoft 365 tenant it goes to Microsoft 365. Use the phone's own mail app, Gmail or Samsung Email instead.
iPhone and iPad
- Settings > Apps > Mail > Mail Accounts > Add Account > Microsoft Exchange (on older iOS versions: Settings > Mail > Accounts).
- Enter the email address and a description, then choose Configure Manually (or Sign In when the domain is not in a Microsoft 365 tenant).
- Enter the password. The server is found automatically.
- If it asks for a server, enter
mail.example.comand the full email address as the username; leave Domain empty. - Choose what to sync: Mail, Contacts, Calendars.
If the organization has phone security rules (see Phones and tablets), the phone asks the person to accept them, for example to set a passcode.
Android
Samsung Email (Galaxy phones): Add account > Microsoft Exchange ActiveSync (on newer versions Other, then Exchange), email address and password, then Manual setup if it does not find the server: server mail.example.com, username = the full email address, domain empty, Use secure connection (SSL) on, port 443.
Gmail app: Settings > Add account > Exchange and Microsoft 365, email address, then Manual setup > Exchange; same settings. The first sync asks to allow remote security administration: accept, or the account will not sync.
Mac: Mail, Calendar and Contacts
- System Settings > Internet Accounts > Add Account > Microsoft Exchange.
- Enter the name and email address and choose Sign In. When asked Sign in to your Exchange account using Microsoft?, choose Configure Manually.
- Enter the password. The server is found automatically; if not, enter
mail.example.comas both the internal and external server. - Tick Mail, Contacts, Calendars.
Outlook
- Outlook for Mac: add an Exchange account with the email address and password. Legacy Outlook for Mac uses Exchange Web Services, which the server supports. If the new Outlook for Mac does not connect, switch to Legacy Outlook (Outlook menu) or add the account as IMAP.
- Outlook for Windows (classic): add the account as IMAP with the settings below. Outlook's own Exchange connection (MAPI over HTTP) is in preview: an administrator turns it on for one person at a time with
sudo oms mapihttp enable <address>, and that person then adds the account as Exchange in a new Outlook profile. Outlook signs in with the password, or with Windows sign-in (NTLM) when that is turned on (see NTLM sign-in for Outlook). - Outlook on the web: use the server's own webmail at
https://mail.example.com/mail.
Outlook and Microsoft 365
Classic Outlook for Windows asks Microsoft 365 about an email address before it asks your own server. When your mail domain is also known to a Microsoft 365 tenant (Teams, Office licences, an old trial or an Azure sign-up all create one), Outlook can take Exchange Online's answer instead, find a different mailbox than the one it has cached, and say "Your mailbox has been temporarily moved on Microsoft Exchange server". Nothing this server answers can prevent it: the fix is one Outlook setting on the PCs, which turns that Microsoft 365 lookup off.
Get started shows Prepare Outlook for Windows when Microsoft 365 knows one of your domains. The server checks this with Microsoft's public sign-in lookup, sending only the domain name; set Oms:ClientAccess:CheckMicrosoft365 to false to turn the check off.
- PCs in a Windows domain: download the Group Policy script (or run
sudo oms outlook gpo-script --out obsidian-outlook-gpo.ps1) and run it once as a domain admin, on a domain controller or a PC with the Group Policy Management tools:powershell -ExecutionPolicy Bypass -File obsidian-outlook-gpo.ps1. It creates the policy Obsidian - Outlook Autodiscover and links it to the domain;-LinkTo 'OU=Staff,DC=example,DC=com'links it to OUs instead. Running it again changes nothing. PCs apply it within about 90 minutes or at the next sign-in. Do this a day or more before people start using Outlook with this server, for example before a migration's cutover. - Other PCs: each person opens the per-person file once (
https://mail.example.com/outlook/prepare-outlook.reg), confirms, and restarts Outlook. No administrator is needed; the link is also under Settings > Connect other apps in webmail. - By hand:
HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\Outlook\AutoDiscover, DWORDExcludeExplicitO365Endpoint=1, then restart Outlook.
If the domain is in a Microsoft 365 tenant only by accident and nothing there uses it, removing the domain from the tenant also solves it, but it changes how people sign in to Microsoft services: it is your organization's decision. Webmail and existing phone and Mac accounts are not affected; only when adding an account on a phone can its setup offer Microsoft sign-in (see Settings for any phone).
Thunderbird and other IMAP apps
Thunderbird fills in everything from the email address and password alone (through the autoconfig record). Other apps need these settings:
| Server | Port | Security | |
|---|---|---|---|
| Incoming (IMAP) | mail.example.com | 993 | SSL/TLS |
| Outgoing (SMTP) | mail.example.com | 587 | STARTTLS |
| Outgoing, alternative | mail.example.com | 465 | SSL/TLS |
| Incoming (POP3), if needed | mail.example.com | 995 | SSL/TLS |
- Username: the full email address, for example
[email protected]. - Password: the person's normal password. Authentication method: normal password.
- The outgoing server always requires signing in, and only sends mail from addresses the person may use.
IMAP on port 143 and POP3 on port 110 also work, but only after the app switches to encryption with STARTTLS; the server never accepts a password over an unencrypted connection.
Printers, scanners and scripts
Devices that send mail (scan-to-email, alerts) can:
- Sign in like an IMAP app: create a user mailbox for the device, and use port 587 with STARTTLS and its address and password.
- Send without signing in, when they cannot do encryption or sign-in: allow their IP address to relay (see Mail flow).
When an app will not connect
- Check that the person can sign in to webmail with the same address and password.
- After 10 wrong passwords within 15 minutes, the account and the IP address are blocked from signing in for a while; wait 15 minutes.
- Check the Setup guide: the
autodiscoverrecord and a trusted certificate are the usual culprits. - See Troubleshooting.