Castellum.

Connect any account

Add Account · Castellum

Castellum connects over standard IMAP/SMTP, so it works with almost any mail provider. Typing your address in the Add IMAP account sheet (the + button in the main window toolbar, or Add… in Settings > Accounts) detects well-known providers automatically and fills in the server settings below, you only need to generate an app password on the provider's side and paste it in. This page covers Gmail, iCloud, Fastmail, Yahoo, generic IMAP, and the current status of Outlook/Microsoft 365.

Why an app password, not your normal password? All of these providers require two-factor authentication (2FA) to be turned on before they'll issue an app password, and the app password is what Castellum stores in your Mac's Keychain, never your account password. Revoking an app password later (from the provider's site) disconnects Castellum without touching your main sign-in.

1. Gmail

  1. Turn on 2-Step Verification if you haven't already: Google Account > Security.
  2. Go to Google Account > Security > App passwords, and generate one for "Mail" / "Castellum".
  3. In Castellum's Add IMAP account sheet, enter your Gmail address, then paste the 16-character app password when prompted.
SettingValue
IMAP hostimap.gmail.com
IMAP port993 (TLS)
SMTP hostsmtp.gmail.com
SMTP port587 (STARTTLS)

Castellum detects @gmail.com and @googlemail.com addresses and fills these in for you; a Google Workspace domain is recognised from its DNS mail records when Look up server settings automatically is on (Settings > General > Account Setup). With it off, apply the Gmail preset yourself from the sheet's "Use settings for…" menu.

2. iCloud Mail

  1. Turn on Two-Factor Authentication for your Apple ID if it isn't already (it's required for iCloud Mail app passwords).
  2. Go to account.apple.com > Sign-In and Security > App-Specific Passwords, and generate one for Castellum.
  3. In Castellum, enter your @icloud.com, @me.com or @mac.com address, then paste the app-specific password.
SettingValue
IMAP hostimap.mail.me.com
IMAP port993 (TLS)
SMTP hostsmtp.mail.me.com
SMTP port587 (STARTTLS)

3. Fastmail

  1. In Fastmail, go to Settings > Privacy & Security > App passwords.
  2. Create a new app password, scoped to "Mail" (IMAP/SMTP) if Fastmail asks.
  3. In Castellum, enter your @fastmail.com or @fastmail.fm address, then paste the app password.
SettingValue
IMAP hostimap.fastmail.com
IMAP port993 (TLS)
SMTP hostsmtp.fastmail.com
SMTP port465 (implicit TLS)

A custom domain hosted at Fastmail is recognised the same way when the lookup is on. Otherwise apply the Fastmail preset from the "Use settings for…" menu.

4. Yahoo Mail

  1. In Yahoo, go to Account Security and turn on two-step verification.
  2. Choose Generate app password, select "Other App" and name it Castellum.
  3. In Castellum, enter your @yahoo.com, @yahoo.co.uk or @ymail.com address, then paste the app password.
SettingValue
IMAP hostimap.mail.yahoo.com
IMAP port993 (TLS)
SMTP hostsmtp.mail.yahoo.com
SMTP port465 (implicit TLS)

5. Generic IMAP (any other provider)

Any provider offering standard IMAP and SMTP access works, even without a built-in preset. You'll need the server settings from your provider (usually on a "mail client setup" or "IMAP/SMTP settings" support page) and, if the provider requires 2FA, an app-specific password the same way as above.

Choose TLS or STARTTLS for IMAP, never None. The Security menu next to the port offers TLS (usually port 993), STARTTLS (usually port 143) and None. Picking the wrong one for a port gives a connection or handshake error. With None your password is sent unencrypted, so do not use it. SMTP works on 465 (implicit TLS) or 587 (STARTTLS).
  1. In the Add IMAP account sheet, enter your email address, if it isn't one of the built-in presets, Castellum leaves the server fields for you to fill in.
  2. Enter the IMAP host and port your provider publishes for implicit TLS, this is almost always TLS on port 993. Leave Security on TLS unless your provider says STARTTLS.
  3. Enter the SMTP host and port (commonly 465 for implicit TLS, or 587 with STARTTLS).
  4. Enter your username (usually your full email address) and password or app password.
  5. Use Test Connection in the sheet to check both legs before saving.

6. Outlook.com / Microsoft 365, not supported yet

Microsoft retired password sign-in for Outlook.com, Hotmail, Live and Microsoft 365 mailboxes, so these accounts need OAuth2 (XOAUTH2) sign-in rather than an app password. Castellum recognises these domains and says so plainly instead of letting you hit an opaque sign-in failure, Microsoft sign-in is planned but is not built yet.

Affected domains: outlook.com, hotmail.com, live.com, msn.com, and their regional variants (e.g. hotmail.co.uk, outlook.es).

Microsoft 365 work or school addresses on your own domain can be recognised from their DNS mail records when the server-settings lookup is on. Either way they will not connect until Microsoft sign-in ships.

7. After you connect