Troubleshooting

All Cheaha apps

Most problems have a short fix. If yours isn't here, get support.

Signing in

  • "didn't accept the user name or password": many providers, including iCloud, Fastmail and Yahoo, don't accept your usual password in other apps. Make an app-specific password in your account's security settings and use that instead. For iCloud, the account form's Make an app-specific password… link opens Apple's page (account.apple.com, then Sign-In and Security, then App-Specific Passwords). Use your Apple Account email address with it.
  • "Signing in took too long": the app waits for you to finish signing in to Google or Microsoft in your browser. If the browser tab was closed, or the sign-in was left unfinished, choose Save (or Sign In Again) and finish it in the browser.
  • Your browser didn't open: sign-in uses your default web browser. Make sure one is set, then try again.
  • A sign-in has expired: Google or Microsoft can end an app's sign-in, for example when you change your password or remove the app's access. The app says so next to the account. Open Settings, then Accounts, select the account and choose Edit…, then Sign In Again. In Cheaha Calendar and Cheaha Contacts you can also right-click the account in the sidebar and choose Account Settings….
  • A work or school Microsoft account says you need an administrator's approval: your organization decides which apps can reach its accounts. Ask your administrator to allow the app.

Servers

  • "took too long to answer" or can't connect: check your internet connection, then the server's address and port in the account's settings. A server that's down or busy usually answers again later.
  • Exchange: the server wasn't found: the apps look for your Exchange server automatically when its address is left empty. If they can't find it, enter the server's address yourself: your IT department has it, and Outlook shows it in its account settings.
  • Microsoft 365 by IMAP or POP in Cheaha Mail: your organization's administrator may have turned off IMAP, POP or authenticated SMTP for your mailbox. Ask them to turn it on, or add the account as Microsoft 365 / Outlook.com instead, which doesn't need them.
  • Saving an account that can't be checked: when the server can't be reached to check your settings, Cheaha Calendar and Cheaha Contacts offer Save Without Checking, to save the account and try again later.

On Linux

  • The AppImage won't open: make sure it's executable (its file Properties, or chmod +x with its name in a terminal). Run it from a terminal to see why it won't start. If the message mentions FUSE, install your distribution's FUSE package, or run the AppImage with --appimage-extract-and-run after its name.
  • Cheaha Mail shows no messages in the reading pane: it needs your system's WebKitGTK. Install libwebkit2gtk-4.1-0 on Debian and Ubuntu, or webkit2gtk4.1 on Fedora. See Installing and updating.
  • Passwords: the apps keep them in your desktop's keyring (GNOME Keyring, KWallet or another Secret Service). With no keyring, they're kept in a file only your user account can read; installing and unlocking a keyring keeps them encrypted. See the Privacy Policy.

Updates

  • An update wasn't installed: most often, the AppImage is in a folder you can't write to. Move it to a folder of your own (such as Applications in your home folder), or download the new version from the home page.
  • No Update button appears: the apps look half a minute after starting and then daily. To look now, choose Check for Updates… in the app's About window, and make sure Check automatically is on there if you want the apps to keep looking.

Still stuck?

Get support, and include the app, its version (in its About window), your system, and the exact words of any message.