Explorar la documentación
Allodia Mail & Calendar

Set up your account

Add a mail account by typing your email address, and what to do when your provider's settings can't be found.

Esta página aún no está traducida, así que estás leyendo la versión en inglés.

You need two things: your email address, and the password you use with your mail provider. The server names, the port numbers and whether your provider also offers a calendar and an address book are things the app tries to work out for itself.

Start with your email address

  1. Open the account list. On macOS and iPad it is the Accounts section of the sidebar; on iPhone, tap the menu button at the top left to slide that sidebar in; on Android, tap the mailbox name at the top of the screen. Then choose Add account….
  2. Type your address and press Continue.

The app then spends a few seconds looking your provider up. It asks the standard places a provider publishes its settings: your own email domain, your provider's domain, an ordinary DNS lookup, and the Thunderbird project's public directory of provider settings. Only the domain is ever sent: example.com, never you@example.com. No password is involved either, because you have not typed one yet.

If nothing turns up within about ten seconds it gives up and offers you the form instead, with a line saying why. It never hangs.

When your settings are found

Check that the server names look like your provider's, type your password, and press Connect.

Tip

If your provider uses two-factor authentication, your normal password will usually be refused here. Most providers can issue an app-specific password for mail apps, from their own account settings. That is the one to use.

The screen has a box for each thing the account can be used for: Email, Calendar and Contacts. Each one reuses the password you are about to type, so there is nothing to enter twice.

  • A calendar or address book that was found is already ticked, with the server it found shown underneath. Untick it if you only want mail.
  • One that was not found starts unticked, as This account also has a calendar or This account also has an address book. Tick it if your provider does have one, and type the server address your provider gives for it.
  • Use this account for mail can be unticked too, for an account you only want for its calendar and contacts. At least one of the three stays ticked.

Some addresses never reach this screen, and that is correct:

  • A Microsoft or Google address asks you what to use the account for, then sends you to that provider's own sign-in page, in your browser. Your password is never typed into Allodia Mail & Calendar. What comes back is a token, stored in your device's secure storage.
  • A provider that supports JMAP, such as Fastmail or a server you run yourself, asks for a password or an API token, whichever your server issues.

Some providers let the app sign in through their own page instead of with a password. The screen then leads with Sign in with your provider, and there is no password to store. Where your password works too, Use a password instead brings the password field back.

When the settings arrive over an insecure connection

A few providers still publish their mail settings over plain, unencrypted HTTP. The app will use them, but not quietly:

Connect stays disabled until you tick "I trust these settings." That is the whole point of this screen. Settings fetched over an insecure connection could have been altered on the way to you, and an altered server name is a server that receives your password.

So read the two host names before you tick it. They should be at your provider's own domain, the same one their support pages use. If they name something you don't recognise, don't approve it: go to Set up manually and type the servers your provider documents.

Settings found over HTTPS, or through a DNS lookup, never show this screen.

When nothing is found

You can also reach this form at any time with Set up manually. Choose the kind of account under Account type: IMAP, JMAP, Calendar and contacts (CalDAV/CardDAV), Microsoft or Google. For IMAP, fill in:

  • Mail server: the name, for example imap.example.com, with its Port and its security, SSL/TLS or STARTTLS. The port follows the security setting (993 or 143), so change it only if your provider documents another.
  • Email and Password: the address, and the password or app-specific password your provider issued.
  • Outgoing server, SMTP has a port and security choice of its own (465 or 587). Leave it empty and you can read mail but not send it; you can fill it in later.
  • Calendar server, CalDAV URL and Address book server, CardDAV URL are optional.

On macOS and iPhone the outgoing, calendar and address book servers are under Advanced (optional).

Calendar and contacts (CalDAV/CardDAV) is for a server that holds your calendar and contacts but not your mail. Enter its calendar server, its address book server, or both.

To try a different address after all, choose Back (on Android, the system Back). The address you typed is kept.

When the server's certificate is not recognised

When you press Connect, the app checks the server's certificate, as it does on every connection afterwards. If no recognised authority vouches for it, the app does not connect. It shows what the certificate claims and its SHA-256 fingerprint instead.

That is normal for mail software running on your own device or network, such as Proton Mail Bridge, and a reason to stop if you expected a public provider. Connect stays disabled until you tick Always trust this certificate for this server, so tick it only if you know the server, then press Connect again. That trusts this one certificate, on this one server, and nothing else.

Where your password goes

Into your device's own secure storage, which is the Keychain on macOS, iPhone and iPad, and the Android Keystore on Android, and not into the app's database.

The lookup runs once, when you add the account. Whichever server it found is written into that account's settings, so nothing re-resolves it afterwards.

None of this involves Allodia: the app talks to your provider, and to nobody else. The full picture is in the privacy policy.