Airpost
Accounts

IMAP and other providers

Connect Yahoo, iCloud, FastMail, GMX, Yandex, Proton Mail Bridge or any IMAP/SMTP server, and what each connection setting does.

Any provider that offers IMAP for reading and SMTP for sending works with Airpost. For the common ones you only enter your address and a password; Airpost fills in the servers. For everything else you can enter the settings yourself.

Providers with app passwords

Several providers want an app password instead of your normal password, especially when two-factor authentication is on. Create one in your provider’s settings, then paste it into Airpost.

ProviderWhat you need
YahooA unique app password (Yahoo instructions).
iCloudA unique app password (Apple instructions).
FastMailAn app password of type IMAP (FastMail instructions). To also sync calendars and contacts, give it CalDAV and CardDAV access.
GMXIMAP turned on in GMX (GMX instructions).
YandexIMAP turned on, possibly a linked phone number, and an app password if you use two-factor auth.

Pick the provider on the Connect an email account screen and enter your Name, Email and Password. Airpost fills in the server settings.

If the password is rejected, Airpost reminds you that some providers require an app password. That is the most common reason a Yahoo or iCloud account fails to connect.

# The same from the CLI, reading the app password from a password manager
op read "op://Personal/iCloud app password/password" | \
  airpost account add me@icloud.com --provider icloud --password-stdin

Any IMAP/SMTP server

Choose IMAP / SMTP

Pick IMAP / SMTP and enter your name, email address and password, then click Continue.

Check the server settings

Airpost tries to detect your settings (see how discovery works). Check or fill in the Incoming Mail (IMAP) and Outgoing Mail (SMTP) columns.

Connect

Click Connect Account. The engine logs in to both servers before it saves anything. If one fails, you see the server’s answer and can fix the setting.

Connection settings

Each column has these fields:

FieldNotes
ServerThe host name, for example imap.example.com.
PortPick a standard port or choose Custom to type one. Picking a standard port also sets the matching security.
SecuritySSL / TLS, STARTTLS or None.
Allow insecure SSLAccepts certificates that can’t be verified, such as self-signed ones. The connection is still encrypted, but not authenticated. Use only on servers you trust.
Username and PasswordUsually your email address and password.

Standard ports and the security they imply:

ProtocolPortSecurity
IMAP993SSL / TLS
IMAP143STARTTLS
SMTP465SSL / TLS
SMTP587STARTTLS
SMTP25STARTTLS

Unencrypted connections

Discovery never chooses None. If you pick it yourself for a server that isn’t on your own machine, Airpost shows a Send password unencrypted checkbox that you must tick before it will connect. The consent is tied to that host name, so if you later change the server, you’re asked again. Connections to 127.0.0.1, localhost or ::1 don’t ask, because the traffic never leaves your computer.

The CLI doesn’t offer cleartext at all: --imap-security and --smtp-security accept only tls and starttls.

Custom Container Folder

The IMAP column also has Custom Container Folder: the parent folder for folders Airpost creates on the server, such as the one snoozed mail moves to. The default is Airpost. Change it if your server requires custom folders under a particular parent (Proton Mail Bridge uses Folders, which Airpost sets for you).

Change settings later

Open the account in Preferences > Accounts and click Update connection settings… to change the password, servers or ports. To change just the password from the CLI:

airpost account reauth me@example.com               # asks on the terminal
printf '%s\n' "$NEW_PASS" | airpost account reauth me@example.com --password-stdin

The engine tests the new credentials before replacing the old ones.

Add a custom server from the CLI

airpost account add me@example.com --name "Ada Lovelace" \
  --imap-host mail.example.com --imap-port 993 --imap-security tls \
  --smtp-host mail.example.com --smtp-port 587 --smtp-security starttls

Any flag you leave out comes from discovery. --imap-username and --smtp-username set a login that differs from the address.

Proton Mail Bridge

Proton Mail works through Proton Mail Bridge, which runs on your computer and exposes a local IMAP and SMTP server. Start Bridge, copy the password it shows for your account (not your Proton password), then add the account with IMAP / SMTP. For proton.me, protonmail.com and protonmail.ch addresses Airpost fills in Bridge’s defaults:

SettingValue
IMAP127.0.0.1, port 1143, STARTTLS
SMTP127.0.0.1, port 1025, STARTTLS
Allow insecure SSLOn (Bridge uses a self-signed certificate)
Container folderFolders

Bridge must be running for Airpost to sync or send. If you changed Bridge’s ports, use the ones Bridge shows.

Servers Airpost adapts to

The engine identifies the server on every connection, from its greeting, capabilities and ID response, and adjusts for known quirks. You don’t configure any of this.

ServerWhat changes
iCloudQRESYNC is never enabled.
YahooSearch without a charset; Yahoo’s mod-sequence extension; copied message IDs re-verified because Yahoo reorders them.
YandexAbrupt disconnects during IDLE are treated as normal.
CourierIDLE and NAMESPACE are assumed even when not advertised.
DovecotA BYE on a UIDVALIDITY change is expected.
Coremail / NetEaseID is sent before selecting a folder; the C-prefixed tags are handled.
hMailServer, home.plAn unreliable UIDNEXT is worked around.
Proton Mail BridgeIts All Mail folder is skipped and duplicate folder entries are merged.
Gmail, Office 365See Gmail and Microsoft.

On servers that allow custom IMAP keywords, Airpost can store labels as keywords. Servers that don’t (Exchange, for example) just use folders.

Calendars and contacts

Airpost finds CalDAV and CardDAV for IMAP accounts automatically where the provider offers them, through DNS SRV records or a built-in list. See Calendar and contacts.

Troubleshooting a connection

SymptomLikely cause
“Authentication failed” on Yahoo, iCloud, FastMailAn app password is required.
Timeout on connectWrong port, or a firewall blocking 993/465/587.
Certificate errorA self-signed or expired certificate. Fix the server, or tick Allow insecure SSL if you trust it.
Connects, but sending failsSMTP needs a different username, port 465 instead of 587, or your provider blocks port 25.
Folders appear under an unexpected parentAdjust Custom Container Folder.

airpost logs me@example.com shows the engine’s log for the account, including the server’s own error text. More in Troubleshooting.