Accounts
Supported providers, how sign-in and credentials work, and every account setting in Preferences > Accounts.
Airpost works with any provider that offers IMAP and SMTP. Google and Microsoft accounts sign in through your browser with OAuth; everything else uses a password or an app password. Calendars and contacts come from the same accounts, with nothing extra to set up.
Each account is run by the Airpost engine, the Rust process that syncs mail, sends, and executes scheduled work. The desktop app, the CLI, the MCP server and the web client all talk to that same engine, so an account you add in one shows up in the others. See How Airpost works for the bigger picture.
Supported providers
| Provider | How you sign in | Guide |
|---|---|---|
| Gmail or G Suite | Browser sign-in (OAuth) | Gmail |
| Office 365 | Browser sign-in (OAuth) | Microsoft |
| Outlook.com / Hotmail | Browser sign-in (OAuth) | Microsoft |
| Yahoo | App password | IMAP and other providers |
| iCloud | App password | IMAP and other providers |
| FastMail | App password (type IMAP) | IMAP and other providers |
| GMX | Password, IMAP enabled at GMX | IMAP and other providers |
| Yandex | Password or app password, IMAP enabled at Yandex | IMAP and other providers |
| Proton Mail (through Proton Mail Bridge) | IMAP / SMTP with the Bridge password | IMAP and other providers |
| Any IMAP / SMTP server | Server settings | IMAP and other providers |
Beyond the list on the setup screen, the engine recognises a number of servers by their greeting and capabilities and adjusts for their quirks: Gmail, Office 365, iCloud, Yahoo, Yandex, Zoho, Proton Mail Bridge, DavMail, Dovecot, Cyrus, Courier, Coremail, hMailServer, Hermes and home.pl. You don’t pick these; the engine detects them on every connection.
How an account is added
Server discovery runs in this order, and stops at the first answer:
- A built-in table of providers, matched by the address’s domain and then by the domain’s MX records (so a custom domain hosted at a known provider is recognised).
- For password accounts, the domain’s Thunderbird autoconfig file (
autoconfig.<domain>, then<domain>/.well-known). - A provider table derived from Thunderbird’s ISPDB, by domain and then by the preset you picked.
imap.<domain>andsmtp.<domain>as a last guess.
Discovery never picks an unencrypted connection. Ports 143 and 25, or an unknown security setting, become STARTTLS. The engine then tests the login before it keeps the account, so a wrong password is caught at setup rather than later.
Add an account
Choose Add Account from the Airpost menu (macOS) or the File menu (Linux), or click Add account… in Preferences > Accounts. Pick a provider on the Connect an email account screen and follow the prompts.
The CLI’s account commands act on the engine’s account list. The desktop window keeps its own list and order, so an account removed with airpost account remove stays listed in the window until you remove it there too.
Where credentials live
Passwords and OAuth refresh tokens never go into the mail database or a config file in plain text. The engine keeps them as one keyset in a single item of your OS secret store, so the keychain prompts at most once:
| Platform | Store |
|---|---|
| macOS | Keychain, generic password item with service Airpost Engine |
| Linux desktop | Secret Service (GNOME Keyring, KWallet), service Airpost Engine |
| Headless or server | secrets.enc in the config directory, AES-256-GCM, with the key from AIRPOST_ENGINE_KEY_FILE or systemd’s $CREDENTIALS_DIRECTORY |
There is no plaintext fallback. If none of these is available, the engine refuses to store secrets. A keyset that exists but can’t be read (a locked keychain, a wrong key file) is treated as an error, never as empty, so a later write can’t wipe your credentials. Secrets are read back only by the engine; no client, including the CLI or MCP server, can ask for them. More in Security model.
Manage an account
Select an account in Preferences > Accounts to change it. Drag accounts in the list to change their order in the sidebar.
| Setting | What it does |
|---|---|
| Name in the sidebar | The label shown for the account. |
| Your name on sent mail | The name recipients see. |
| Colour | Marks the account in the sidebar and message list. Default: none. |
| Always copy | Adds Cc or Bcc addresses to every message you write from this account. |
| Other addresses you send from | Aliases you can pick in the From field. |
| New messages from | The default From address for new mail. Default: the account’s own address. |
| Save drafts to server | Saves drafts to the account’s Drafts folder, so they show up in webmail and on your other devices. |
| Shared mailbox | Office 365 only. See Microsoft. |
| Manage contacts | Opens the account’s address book. See Calendar and contacts. |
| Rebuild this account | Deletes the local cache for this account and downloads its mail again. Use it when mail is missing or looks wrong. |
| Remove this account | Deletes its mail from this computer. The mail stays on your provider’s server. |
For Google and Microsoft accounts, Sign in again… renews the browser sign-in. For other accounts, Update connection settings… changes the password, servers or ports.
The same operations from the CLI:
airpost accounts # list accounts with their ids and state
airpost account update me@example.com --name "Ada L." \
--alias "Ada <ada@example.org>" --default-alias ada@example.org
airpost account reorder work@example.com me@example.com
airpost account resync me@example.com # same as Rebuild this account
airpost account reauth me@gmail.com # browser again, or a new password
airpost account remove me@example.com # add --delete-data to drop the cache too
remove and resync ask for confirmation on a terminal; pass -y in scripts or with --json. Without --delete-data, remove keeps the downloaded mail, so adding the account back later doesn’t download everything again. Removing a Google account also revokes Airpost’s grant at Google.
When an account stops syncing
| What you see | What it means | What to do |
|---|---|---|
| “Airpost can’t sign in” | The password changed, or the provider revoked the OAuth token. | Click Reconnect (or airpost account reauth). |
| “Mail for … stopped syncing” | The engine hit an error it couldn’t get past. | Reconnect; if it keeps happening, rebuild the account. |
| Calendars or contacts stale, mail fine | The calendar and contacts worker backs off after errors (see Calendar and contacts). | Wait, or run airpost calendar sync. |
Per-account logs help when the cause isn’t obvious: airpost logs me@example.com. See Troubleshooting.
Coming from Mailspring
Airpost started from Mailspring’s code and can read its profile. If you have a Mailspring profile on this computer, use Import from Mailspring under the account list in Preferences > Accounts, or the prompt on the Connect an email account screen. Nothing is imported unless you ask.
- With no accounts in Airpost yet, the import copies the whole Mailspring profile in (mail cache, accounts, settings) and restarts.
- With accounts already in Airpost, it only adds the Mailspring accounts Airpost doesn’t have.
The Mailspring profile is only read, never changed, so you can keep using Mailspring alongside.
Switching between accounts
Press Cmd+1 through Cmd+9 (macOS) or Ctrl+1 through Ctrl+9 (Linux) to jump to an account in the sidebar. Most CLI commands take --account <id|email> to pick one; with a single account it’s the default.