How to set up your iPhone, iPad or iPod Touch: iOS10

Did you know: Fastmail has an excellent iOS app which many of our users prefer to other mail apps. See our mobile app help for more details.

iPhone, iPad and iPod apps needs their own app password to access your information. If you use your normal password or your Fastmail two step verification password on an external account, syncing to an external service won't work and you will see a password error.

Automatic or manual configuration

It's easier and less error-prone to use our automatic configuration tool.

However in certain circumstances, you may need to manually configure your account.

The instructions and screenshots in this setup guide are for iOS 10. Previous versions of iOS are similar, although the screenshots will not match what you see on your device.

For iOS 11 all account settings are held in Settings, then Accounts & Passwords, but otherwise the steps are the same for manual configuration.

Set up your email

  1. Open the Settings app.
  2. Tap Passwords & Accounts.
  3. Tap Accounts, Add Account, then Other (at the bottom of the list), then Add Mail Account.
  4. Fill in your name, email address and app password:

    • Name: The name people will see on the email you send.
    • Email: Your full Fastmail username, including the domain.
    • Password: Your iPhone app password. (What's an app password?)
    • Description: A name to identify this account (anything you like).

  5. If you're using a custom domain, you need to enter your Host Name, Username and Password for incoming and outgoing mail servers.

    • Incoming Host Name: imap.fastmail.com
    • Outgoing Host Name: smtp.fastmail.com
    • Username: your full Fastmail username, including the domain.
    • Password: your iPhone app password (What's an app password?)
  6. Tap Next, then tap Save.

Note: You can also add aliases to your device.

Your Fastmail account is now ready to use; open the Mail app to read your email. In addition, you can also sync your calendar with your device.

My mail isn't showing up at all

Check the IMAP Path Prefix settings.

My folders show as subfolders of my Inbox. How do I fix this?

This is for clients using the old mail.messagingengine.com server only. This issue is fixed if you're using imap.fastmail.com

The default settings used by iOS for Fastmail accounts shows all folders other than the system ones (Archive, Sent, Trash etc.) as subfolders of the Inbox, even though they should be at the same hierarchical level. To fix this:

  1. Open the Settings app.
  2. Tap Passwords & Accounts.
  3. Tap your Fastmail account in the Accounts list. It will be labelled with whatever you typed in for the Description field when you set it up.
  4. Tap Account, scroll to the bottom and tap Advanced.
  5. In the IMAP Path Prefix box (part of the Incoming Settings section), type INBOX.

  1. Tap to go back to your Account, then tap Done.

Set up your calendar

  1. Open the Settings app.
  2. Tap Passwords & Accounts.
  3. Tap Accounts, Add Account, then Other (at the bottom of the list), then Add CalDAV Account.
  4. Fill in the server name, your username and app password:

    • Server: caldav.fastmail.com
    • User Name: Your full Fastmail username, including the domain.
    • Password: Your iPhone app password. (What's an app password?)
    • Description: A name to identify this account (anything you like).
  5. Tap Next, then tap Save.

Your Fastmail calendars will now sync with your phone and are ready to use; open the Calendar app to view and edit your calendar.

If you'd like to also use your calendar also for iPhone reminders, you can also enable this in the iPhone Settings app.

Warning: Deleting a Reminders list from your phone will also delete the associated Fastmail calendar off the server and your phone.

Set up your contacts

  1. Open the Settings app.
  2. Tap Passwords & Accounts.
  3. Tap Accounts, Add Account, then Other (at the bottom of the list), then Add CardDAV Account.
  4. Fill in the server name, your username and app password:

    • Server: carddav.fastmail.com
    • User Name: Your full Fastmail username, including the domain.
    • Password: Your iPhone app password. (What's an app password?)
    • Description: A name to identify this account (anything you like).
  5. Tap Next, then tap Save.

Your Fastmail contacts will now sync with your phone and are ready to use; open the Contacts app to view and edit your contacts.

Note: This will sync all CardDAV accounts by default (both personal and shared). If you want to sync them separately, create individual CardDAV accounts. Use the same server name and app password, but set the username to select the specific contact list:

Be aware that any pre-existing contacts already on your device do not automatically get copied back up to Fastmail with the sync: you need to import them to Fastmail first.

Set up notes

  1. Open the Settings app.
  2. Tap Passwords & Accounts.
  3. Under Accounts, select your Fastmail account from the list if you have already added it for email, calendaring or contacts. Or add it now following the email instructions.
  4. Enable the Notes option.

You can now verify it's working in the Notes application.

  1. Open the Notes app
  2. There will be an option at the top to back to the Accounts list.
  3. You will now see a list of places where your Notes are stored and select which set of Notes you want to view.

If you'd like to use Fastmail storage as the default location for new notes to ensure they are backed up and always available:

  1. Open the Settings app.
  2. Tap Notes
  3. Select Default Account
  4. Choose Fastmail for your desired default account.

If your Notes do not display, check the advanced server settings.

Updating your password

If you change an iPhone app password after adding your Fastmail account to your iOS device, you will need to update the settings.

Depending on what kind of access the app password granted (just mail; or mail and calendars; or mail, calendars, contacts) affects which passwords you will need to update in your phone. Note that access to Notes is controlled by your Mail password.

For Mail (and Notes):

  1. Open the Settings app.
  2. Tap Passwords & Accounts.
  3. Tap your Fastmail account in the Accounts list. It will be labelled with whatever you typed in for the Description field when you set it up.
  4. Tap Account, and scroll down to the "Incoming Mail Server" section.
  5. Tap to focus the Password field, delete the current contents and type in your new iPhone app password..
  6. Now tap scroll down to the "Outgoing Mail Server" section and tap the first (and probably only) entry, called something like SMTP smtp.fastmail.com.
  7. Tap the first entry, smtp.fastmail.com, under the "Primary Server" heading.
  8. Tap to focus the Password field, delete the current contents and type in your new app password.
  9. Tap Done, then go back to Account then tap Done again.

You should be able to both send and receive mail again with your Fastmail account. If you can do one, but not the other, try following the steps again carefully: your password may have been updated for incoming mail, but not for outgoing mail, or vice versa.

If you have your calendar set up on your device, you will need to update the password there as well:

  1. Open the Settings app.
  2. Tap Passwords & Accounts.
  3. Tap your Fastmail calendar account in the Accounts list at the top. It will be labelled with whatever you typed in for the Description field when you set it up.
  4. Tap Account, then tap to focus the Password field, delete the current contents and type in your new app password.
  5. Tap Done.

For Contacts:

  1. Open the Settings app.
  2. Tap Passwords & Accounts.
  3. Tap your Fastmail contacts account in the Accounts list at the top. It will be labelled with whatever you typed in for the Description field when you set it up.
  4. Tap Account, then tap to focus the Password field, delete the current contents and type in your new app password.
  5. Tap Done.