Automatic account setup on Mac

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.

  1. Log in to the Fastmail web interface on your Mac and go to the Password & Security screen. Unlock it with your password, then click Manage.
  2. Click New App Password.
    1. Give your app password a name to indicate which device and app this password is for.
    2. Choose what sort of access this password requires.
  3. Click Generate Password.
  4. 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.
  5. 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.

Looking for instructions on how to manually set up Mail, Calendar, or Contacts?

Adding your other email addresses

To use a different email address to your Fastmail username:

  1. Go to MailPreferences and select the Accounts tab.
  2. Select your Fastmail account on the left.
  3. Use the Aliases pop up menu to access your alternate addresses.

  4. Use the Edit Aliases option to add, delete or change your list of alternate addresses.

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.

  1. Open Mail, go MailPreferences and select the Accounts tab to view your list of Accounts.
  2. Select your Fastmail account.
  3. 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.

If you'd prefer to update your passwords manually: Mail, Calendar, and Contacts.

Remove a Fastmail Profile

To delete Fastmail from your Mac, you need to remove the Profile.

  1. Open System Preferences
  2. Go to Profiles
  3. 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.