Set Up TrekMail in Apple Mail on Mac, iPhone, and iPad

Apple Mail is one of the guided choices in TrekMail's Apps & devices screen. The recommended method is a small Apple configuration profile that adds the incoming and outgoing account settings together. Manual setup remains available if your organization does not allow profiles.

Before you start

• Have the full mailbox address ready, such as hello@example.com.
• Prepare an app password, or the mailbox password if the mailbox still accepts it. Do not use your TrekMail dashboard password.
• Open Apps & devices and confirm that sending is ready. Apple Mail may reject the account when receiving works but outgoing mail has not been configured.
• If the address already exists in Apple Mail as a failed account, remove only that account or its TrekMail profile before retrying. Do not delete unrelated Keychain entries or other accounts.

You can find Apps & devices in either place:

1. In the TrekMail dashboard, open Mailboxes, select the mailbox, then choose Apps & devices.
2. In webmail, click the settings gear and choose Apps & devices, directly above Connected accounts.

Check the sign-in mode there. App passwords only requires an app password; Mailbox password or app passwords accepts either. Create one in webmail under Settings > App passwords, or in the dashboard under Mailboxes > the mailbox > Security > App passwords. See Mail app passwords.

Recommended: install the Apple configuration

On the Apple device you want to connect:

1. Open Apps & devices and choose Apple Mail.
2. Select Download configuration. A .mobileconfig file downloads.
3. On a Mac, open System Settings → General → Device Management. On an iPhone or iPad, open Settings → General → VPN & Device Management.
4. Open the downloaded TrekMail profile, review it, and approve Install.
5. Enter the app password when Apple Mail asks, or the mailbox password if the mailbox still accepts it. The same password is used for incoming and outgoing mail.
6. Open Mail and allow a moment for the first folder sync.

The profile contains the mailbox address and secure server settings. It never contains a password; macOS or iOS asks for it during installation.

Manual setup

If profiles are blocked by your administrator, choose Show IMAP and SMTP settings in Apps & devices. In Apple Mail, add an Other Mail Account and use these values:

Port 587 with STARTTLS is also available when an Apple-managed network blocks port 465.

The usual platform hosts are imap.trekmail.net and smtp.trekmail.net. A verified White Label setup can show branded hosts instead. If your domain routes mail through a custom SMTP provider, still use the outgoing host shown by TrekMail. Provider credentials do not belong in Apple Mail.

If receiving or sending does not work

1. In Apple Mail, open Mail → Settings → Accounts, select the TrekMail account, and confirm it is enabled.
2. Open Server Settings. Check that both usernames are the complete mailbox address.
3. Confirm the outgoing account assigned to this mailbox matches the outgoing host in Apps & devices. A server saved in the list but assigned to a different account will not send for this mailbox.
4. If you entered the account manually, turn off Automatically manage connection settings and recheck ports 993 and 465.
5. On a Mac, open Window → Connection Doctor. It tests incoming and outgoing connections separately, so you can see which side failed.

If you see "Sign-in failed. This mailbox accepts app passwords only: create one in webmail under Settings > App passwords.", create one there and update both incoming and outgoing passwords. Apple Mail may show only a generic password error. A replaced or revoked app password also needs to be updated.

Do not repeatedly clear Keychain. To remove an installed TrekMail profile cleanly, open System Settings → General → Device Management and remove that profile. This removes only the account created by the profile.