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.
1. Gmail
- Turn on 2-Step Verification if you haven't already: Google Account > Security.
- Go to Google Account > Security > App passwords, and generate one for "Mail" / "Castellum".
- In Castellum's Add IMAP account sheet, enter your Gmail address, then paste the 16-character app password when prompted.
| Setting | Value |
|---|---|
| IMAP host | imap.gmail.com |
| IMAP port | 993 (TLS) |
| SMTP host | smtp.gmail.com |
| SMTP port | 587 (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
- Turn on Two-Factor Authentication for your Apple ID if it isn't already (it's required for iCloud Mail app passwords).
- Go to account.apple.com > Sign-In and Security > App-Specific Passwords, and generate one for Castellum.
- In Castellum, enter your
@icloud.com,@me.comor@mac.comaddress, then paste the app-specific password.
| Setting | Value |
|---|---|
| IMAP host | imap.mail.me.com |
| IMAP port | 993 (TLS) |
| SMTP host | smtp.mail.me.com |
| SMTP port | 587 (STARTTLS) |
3. Fastmail
- In Fastmail, go to Settings > Privacy & Security > App passwords.
- Create a new app password, scoped to "Mail" (IMAP/SMTP) if Fastmail asks.
- In Castellum, enter your
@fastmail.comor@fastmail.fmaddress, then paste the app password.
| Setting | Value |
|---|---|
| IMAP host | imap.fastmail.com |
| IMAP port | 993 (TLS) |
| SMTP host | smtp.fastmail.com |
| SMTP port | 465 (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
- In Yahoo, go to Account Security and turn on two-step verification.
- Choose Generate app password, select "Other App" and name it Castellum.
- In Castellum, enter your
@yahoo.com,@yahoo.co.ukor@ymail.comaddress, then paste the app password.
| Setting | Value |
|---|---|
| IMAP host | imap.mail.yahoo.com |
| IMAP port | 993 (TLS) |
| SMTP host | smtp.mail.yahoo.com |
| SMTP port | 465 (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.
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).- 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.
- 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. - Enter the SMTP host and port (commonly
465for implicit TLS, or587with STARTTLS). - Enter your username (usually your full email address) and password or app password.
- 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
- Test Connection checks the IMAP login and folder list, and the SMTP login, for the details currently in the sheet. It saves and syncs nothing. When you then press Sync, Castellum runs the same check itself first, so a wrong password fails fast; if a Test Connection with exactly the same settings has already passed, it is reused. Editing a field marks an earlier result as out of date.
- Choose what to sync. The sheet lets you pick how much history to import (last month, 3 months, 12 months or all mail) and, after a test, which folders. You can change folders later in Settings > Accounts > Folders….
- The first sync can take a while on a large mailbox.
- New accounts start read-only. Castellum shows your mail but will not archive, delete, flag or send until you enable writes. This is deliberate; see Read-only (evaluation) mode.
- Later changes, such as a new password, are in Managing accounts. If something goes wrong, see Status and Diagnostics.