Office Help

App passwords & devices

App passwords

An app password is a password of its own for exactly one device or program: Apple Mail, Thunderbird, DAVx⁵, FairEmail, your phone's calendar app. Your usual password and signing in through Accounts do not work in these programs.

Which app password for what

  • Mail, Calendar and Contacts share their app passwords. One you make in any of the three works for IMAP, SMTP, CalDAV and CardDAV.
  • Box has app passwords of its own, for WebDAV programs. The Nextcloud apps need none: when you set them up they open the browser, and you allow the device there. That makes an app password named after the device by itself. See Nextcloud apps and WebDAV.

Making an app password

  1. Open Mail, Calendar or Contacts (or Box, for WebDAV).
  2. Click your name at the bottom left and choose App passwords….
  3. Under Device name, say what the password is for, for example "Anna's phone".
  4. Choose Create password.
  5. Enter the password in the program now. It is shown only this once.
The App passwords dialog with server addresses, the Device name field and the existing app passwords
At the top the addresses for your program, below them your app passwords

Each address in the dialog has a button to copy it. As the user name, enter your email address.

Settings for your program

FieldValue
User nameyour email address, e.g. anna@example.org
Passwordthe app password
Incoming (IMAP)mail.example.org, port 993, SSL/TLS
Outgoing (SMTP)mail.example.org, port 587, STARTTLS
Calendar (CalDAV)https://calendar.example.org
Contacts (CardDAV)https://contacts.example.org

Guides for your device

Where to enter the details on your device or in your program is on these pages:

Revoking an app password

The App passwords… dialog lists all your app passwords with when they were made and last used. Revoke makes one invalid at once. The program using it can no longer connect.

If it doesn't work

  • The program says the password is wrong. Check that you entered the app password and not your usual one, and that the user name is your full email address.
  • It worked for a long time and suddenly stopped. The app password may have been revoked, or you haven't signed in in the browser for a while. Sign in once, or make a new app password.
  • Mail arrives, but sending fails. SMTP needs port 587 with STARTTLS, not 465.
Office Help