Adding email accounts

Cheaha Mail

Cheaha Mail works with four kinds of account, and you can add as many as you like.

Adding an account

Choose Add Account at the bottom of the mailbox list (or Add Account… on the welcome screen, Mailbox › Add Account… on a Mac, or Add in Settings › Accounts). The Add Account window opens.

  • Under Account type, choose IMAP, POP3, Microsoft 365 / Outlook.com or Exchange Server. If you're not sure, leave it on IMAP. For Outlook.com and Hotmail addresses, Cheaha Mail switches to Microsoft 365 / Outlook.com for you once you've typed your address.
  • Type your Email address. When you move on, Cheaha Mail looks up the server settings for it and fills them in.
  • Fill in the password or sign-in (see below), Your name (shown to people you write to) and a Description (such as Work or Personal; it's the account's name in the mailbox list).
  • Optionally add a Signature. It's added to new messages, replies and forwards from this account.
  • Choose the button at the bottom right: Add Account, or Sign In with Google, Sign In with Microsoft or Sign In when the account signs in through your browser.

Before saving, Cheaha Mail checks the account by signing in to its servers. If that fails, it says what went wrong. Fix the setting and try again, or, if you know the settings are right (for example, you're offline), choose Save Without Checking.

The account type can't be changed after an account is added. To switch, add the account again with the other type and remove the old one.

Which type to choose

  • IMAP: mail stays on the server and looks the same on all your devices. Best for most providers, including Gmail, iCloud, Yahoo, AOL, Fastmail and Zoho.
  • POP3: new mail is downloaded to this computer. Use it only when your provider doesn't offer IMAP.
  • Microsoft 365 / Outlook.com: Outlook.com, Hotmail and Microsoft 365 work or school accounts (Exchange Online).
  • Exchange Server: an Exchange server run by your organization.

Signing in with Google or Microsoft

For IMAP and POP3 accounts, a Sign in choice may appear under the email address: Password, Sign in with Google or Sign in with Microsoft.

  • Gmail addresses (gmail.com, googlemail.com) choose Sign in with Google for you.
  • Google Workspace addresses on your own domain can choose Sign in with Google.
  • Microsoft 365 addresses on your organization's domain can choose Sign in with Microsoft. Your administrator must have IMAP or POP, and authenticated SMTP, turned on for your mailbox.

When you choose Sign In with Google (or Microsoft), your web browser opens the provider's own sign-in page, and Cheaha Mail waits for you there. Cheaha Mail gets permission to read and send your mail, and never sees your password, so you don't need an app password. Once you're done, the window shows Signed in as with your address, and you can return to Cheaha Mail. The server settings are filled in with the provider's servers.

If a Google or Microsoft sign-in expires or is revoked, the account shows a warning in the mailbox list. Open Settings › Accounts, choose the account, choose Edit…, then Sign In Again, and sign in with the button at the bottom.

If you don't see the sign-in choice, sign in with a password or app password instead.

Signing in with a password or app password

Choose Password and type your account's password. Some providers don't accept your normal password in an email app and need an app password (an app-specific password) instead, which you create in your account's security settings on the provider's website. Cheaha Mail shows a note when that's the case:

  • iCloud, Yahoo, AOL and Fastmail need an app password.
  • Gmail needs an app password if you sign in with a password rather than with Google.
  • Proton Mail works through Proton Mail Bridge on your computer. Use the password Bridge shows, and trust its certificate.

Yahoo, AOL and iCloud don't offer "Sign in with…" to apps like this one, so they always use app passwords.

Server settings

For IMAP and POP3 accounts, the Servers section shows the incoming and outgoing servers Cheaha Mail found. It gets them from its own list of common providers, then from Mozilla's public database of email providers (the one Thunderbird uses), and otherwise guesses imap. and smtp. followed by your domain. Find Settings looks them up again.

Choose Details to see or change them:

  • Incoming (IMAP) or Incoming (POP3): Server, port, security and User name. Leave the user name empty if it's the same as your email address.
  • Outgoing (SMTP): Server, port and security.
  • Security can be SSL/TLS, STARTTLS or None (unencrypted). When you change it, the port changes to the usual one (993 or 143 for IMAP, 995 or 110 for POP3, 465 or 587 for SMTP) unless you typed a different port. Avoid None unless your provider tells you to use it: your password and mail would cross the network unencrypted.
  • Sign in with the incoming server's user name and password is on by default. Turn it off if your outgoing server needs a different User name and Password.

Your provider's help pages list the right settings if the ones found don't work.

POP3 accounts

A POP3 account downloads new mail into mailboxes on this computer: Inbox, Drafts, Sent, Archive, Junk and Trash. Everything you do with that mail (reading, flagging, moving, deleting) happens only on this computer, and messages you send are kept in its local Sent mailbox.

  • Leave messages on the server (under Details, on by default) keeps a copy on the server after downloading, so other devices can still get it. Turn it off to have Cheaha Mail remove messages from the server once they're downloaded.
  • Removing a POP3 account deletes the mail it downloaded from this computer.

IMAP accounts

An IMAP account works with the mail on the server: your folders, read and flagged status, and moves and deletions are the same everywhere you read that account. A copy of each message you send is saved in the account's Sent mailbox.

Microsoft 365 / Outlook.com

Choose Microsoft 365 / Outlook.com for Outlook.com, Hotmail and Microsoft 365 accounts. Cheaha Mail connects to these through Microsoft Graph, Microsoft's service for apps.

Choose Sign In, and your browser opens Microsoft's sign-in page. Cheaha Mail gets permission to read and send your mail, never sees your password, and stays signed in until you remove the account. If the sign-in expires later, Cheaha Mail opens your browser again so you can sign back in. Messages you send are saved in Sent Items.

Exchange Server

Choose Exchange Server for an Exchange server run by your organization (it connects with Exchange Web Services).

  • EWS address: leave it empty, and Cheaha Mail finds your server from your email address, the way Outlook does. If it can't, it tries the usual address and then asks you to enter it. Your IT department, or Outlook's account settings, can tell you the address; it starts with https://.
  • User name: your Windows sign-in, such as DOMAIN\user, or your email address.
  • Password: your Windows password.

Your password is only sent over encrypted (https) connections.

Changing or removing an account

Open Settings › Accounts.

  • Edit… (or double-click the account) opens Account Settings, where you can change everything but the account type. Password fields say Unchanged: leave them empty to keep your saved password. Choose Save when you're done; Cheaha Mail checks the account again.
  • Remove takes the account out of Cheaha Mail, along with its saved password or sign-in. Its messages stay on the server; mail downloaded with POP3 is deleted from this computer.
  • Move Up and Move Down change the order of your accounts in the mailbox list.

Where your passwords are kept

Cheaha Mail keeps passwords, app passwords and Google and Microsoft sign-ins in your system's secure storage, never in its settings file:

  • macOS: the Keychain.
  • Windows: a file in the app's data folder, encrypted with Windows' own data protection for your user account.
  • Linux: your desktop's keyring (through Secret Service, such as GNOME Keyring). On a desktop without a keyring, they're kept in a file that only your user account can read.

Removing an account removes its saved passwords and sign-ins. For more, see Settings and privacy and our privacy policy.