Waymaker
Email

Set Up Email in Apple Mail (macOS)

Learn about Set Up Email in Apple Mail (macOS) in WaymakerOS.

macOSApple MailSetup
Last updated: April 2026

Set up Mail, Calendar, and Contacts on your Mac in one step using the WaymakerOS configuration profile.

What you'll set up

A single profile download installs three accounts at once:

  • Mail (IMAP + SMTP)
  • Calendar (CalDAV)
  • Contacts (CardDAV)

You don't need to enter any server names, ports, or passwords. The profile carries all of that.

1. Generate a setup code in Commander

Open Commander on the Mac you want to set up.

  1. Open Commander at commander.waymakerone.com
  2. Click Email in the sidebar
  3. Click the Settings gear in the top right of the email view
  4. Switch to the Setup tab
  5. In the Quick Setup (Apple Devices) card, click Generate Setup Code

The card now shows a QR code (for iPhone) and a Download profile for this Mac button. Each click of Generate Setup Code creates two fresh single-use codes — one for the QR, one for the download — so you can install on your iPhone and your Mac from the same generation.

[screenshot: Commander Email Settings, Setup tab, Quick Setup card showing both QR and download button]

2. Download the profile

Click Download profile for this Mac. The file waymaker-os-email.mobileconfig lands in your Downloads folder. The download link is single-use and expires in 10 minutes.

3. Install the profile

  1. Open System Settings → General → VPN & Device Management
  2. Under Downloaded Profile, double-click Waymaker OS Email
  3. Click Install, then Install again to confirm
  4. Enter your Mac password
  5. An "Unsigned Profile" warning appears — this is normal. Continue with Install

[screenshot: macOS System Settings → VPN & Device Management → Waymaker OS profile install dialog]

4. Verify

Open Mail, Calendar, and Contacts. You'll see a new Waymaker OS account in each, syncing your inbox, events, and address book. Initial sync takes a minute or two.

Setting up iPhone and Mac from the same generation

A single click of Generate Setup Code creates one QR code and one download — both single-use, both valid for 10 minutes. To set up both devices in one go:

  1. Click Generate Setup Code in Commander on your Mac
  2. Scan the QR code with your iPhone Camera (see Set Up Email on iPhone & iPad)
  3. Click Download profile for this Mac to install on your Mac

If a code expires, click Generate new code for fresh ones.

Manual IMAP setup (advanced)

If you can't use the profile method — for example, you only want to add mail without calendar or contacts, or your Mac is managed and blocks profile installs — you can configure Apple Mail by hand. The full server settings are in Manual Settings Reference.

Steps

  1. Open Mail
  2. Go to Mail → Add Account
  3. Select Other Mail Account
  4. Click Continue
  5. Enter your name, full email address, and email token (not your Waymaker password)
  6. Click Sign In
  7. When automatic configuration fails, additional fields appear
  8. Select IMAP as the Account Type
  9. Enter the IMAP and SMTP server settings from the Manual Settings Reference
  10. Click Sign In, then Done

For calendar-only or contacts-only setup, see Sync Calendar to Devices or Sync Contacts to Devices.

Troubleshooting

"Profile cannot be installed"

The download link expired. Go back to Commander and click Generate new code, then download again. Links last 10 minutes.

Mail account installed but no messages appear

Initial sync takes a minute or two. Click Get Mail to refresh. If no mail arrives after five minutes:

  1. Go to System Settings → General → VPN & Device Management
  2. Confirm the Waymaker OS Email profile is listed
  3. If not, generate a new code and reinstall

Sent emails not appearing in Sent folder

Apple Mail may save sent items locally instead of on the server:

  1. Open Mail → Settings → Accounts
  2. Select your Waymaker account
  3. Click Mailbox Behaviors
  4. Set Sent Mailbox to the Sent folder on the server (not "On My Mac")

"Unable to verify account name or password"

If you set up manually rather than via profile, make sure you used your email token, not your Waymaker password. Find your token under Setup → Your Credentials in the email Settings panel.

Removing the profile

To uninstall everything in one step:

  1. Open System Settings → General → VPN & Device Management
  2. Select the Waymaker OS Email profile
  3. Click the minus button to remove

This removes Mail, Calendar, and Contacts together.

Tips

Set as default account

To send from your Waymaker email by default:

  1. Open Mail → Settings → Composing
  2. Set Send new messages from to your Waymaker account

Notifications

Configure mail alerts under System Settings → Notifications → Mail.

Keyboard shortcuts

ActionShortcut
New Message⌘N
Reply⌘R
Reply All⇧⌘R
Forward⇧⌘F
Send⇧⌘D
Check for New Mail⇧⌘N