Installing and updating
All Cheaha apps
Each Cheaha app installs on its own: get the ones you want. They're free.
Linux
Each app is an AppImage: one file that runs on most Linux distributions (x64 and Arm64, with glibc), with nothing else to install first.
- Download the AppImage for your computer from the home page: x64 for most PCs, Arm64 for Arm computers such as a Raspberry Pi 5 or an Arm laptop.
- Make it executable, once: in your file manager's Properties, turn on "Allow executing file as program", or in a terminal run
chmod +x Mail-x86_64.AppImage(with your file's name). - Open it by double-clicking it, or from a terminal.
- Keep it somewhere it can stay, such as an
Applicationsfolder in your home folder. Updates replace the file where it is, so that folder has to be one you can write to. - In your app menu: an AppImage doesn't add itself to your desktop's menu. Tools such as Gear Lever or AppImageLauncher do that for you, along with the apps' file types and links (for example,
mailto:links open Cheaha Mail).
What the apps need from your system
- Your passwords are kept in your desktop's keyring (the Secret Service, such as GNOME Keyring or KWallet), which most desktops run already.
- Cheaha Mail's reading pane shows messages with your system's WebKitGTK (
libwebkit2gtk-4.1). GNOME and most desktops include it. If messages show nothing, install it:libwebkit2gtk-4.1-0on Debian and Ubuntu,webkit2gtk4.1on Fedora.
Updates
The Linux apps keep themselves up to date.
- Checking: half a minute after an app starts, and then once a day, it looks for a newer release. When there is one, an Update to… button appears at the right of the status bar.
- Installing: click it and choose Install. The app downloads the new version, checks its signature, replaces its AppImage and starts again. Your accounts and settings are kept.
- Checking yourself: open the app's About window and choose Check for Updates…. Clear Check automatically there if you'd rather the app didn't look by itself.
- If it can't install: the app says why. Most often the AppImage's folder isn't one you can write to: move the AppImage, or download the new version from the home page.
Every update is signed, and the apps refuse any update whose signature doesn't check out.
Windows and macOS
Cheaha Mail, Calendar and Contacts are on their way to the Microsoft Store and the Mac App Store, which will install and update them there. The Mac versions run natively on both Apple silicon and Intel Macs.