Mac Mail, Calendar and Contacts apps need their own app password to access your information. If you use your normal password on an external account, syncing won't work and you will see a password error.
The easiest way to set up a Mac is to use our automatic setup tool which will take care of the app password entry for you.
- Log in to the Fastmail web interface on your Mac and go to the Settings → Password & Security screen. Scroll down to the Third-party apps section and click Manage.(In some screens, the button might say Add instead of Manage).
- Unlock this new screen by entering your password in the yellow box, then click New App Password.
- Give your app password a name to indicate which device and app this password is for.
- Choose what sort of access this password requires.
- Click Generate Password.
- The following screen will show information about the app password that has been created. Click the link that says Open this configuration file. This will download the configuration file to set everything up on your Mac automatically.
- Open the configuration file. Examine the profile ("Show Profile") and make sure it has access to which of email, contacts (CardDAV) and calendars (CalDAV) you require, and install it if it's correct.
If you open your internet accounts list on your Mac, you'll see your accounts listed there. If you open the Profiles tool, you'll see a single entry for your Fastmail accounts.
Adding your other email addresses
To add aliases in Mac Mail:
- In Mac Mail, go to Mail → Preferences and select the Accounts tab.
- Select your Fastmail account on the left.
- Click the Email address dropdown, then Edit email addresses.
- On the following screen, click the + button to add a new address.
- Click OK when done.
In MacOS prior to 10.11 (El Capitan), there is no aliases option. Instead, in the Email Address field, replace your Fastmail username with the address you wish to use instead. You can also enter multiple email addresses, separated by a comma. If you do this, Mail.app will let you choose which one you would like to use each time you compose a message.
Setting up Notes
Warning: The new Notes features are available to OS X 10.11/iOS 9 users only if you are using Apple's upgraded Notes with iCloud support. These extra features are not available if you are using IMAP based Notes through Fastmail. If you don't need the new features, then we recommend you do not upgrade Notes support: once upgraded, you can't go back. Once a note goes onto iCloud, Fastmail will no longer be able to synchronize with it.
If your Mac is set up to access mail, contacts, and calendars, you can also add Notes support.
- Open Mail, go Mail → Preferences and select the Accounts tab to view your list of Accounts.
- Select your Fastmail account.
- Enable the Notes option in the toggle.
Updating your password
If you change your Mac Mail password after adding your Fastmail account to Mail.app, you will need to update the settings. The easiest way to update is to delete the profile off your Mac and use the automatic setup tool to generate a new password and store it on your Mac.
Remove a Fastmail Profile
To delete Fastmail from your Mac, you need to remove the Profile.
- Open System Preferences
- Go to Profiles
- Select the Fastmail profile and use the - button to remove the profile.
This will remove Fastmail from the list of internet accounts on that Mac.