Installing the app

Download the signed APK from GitHub, check its signature if you want to, and keep it up to date.

The app is distributed as a signed APK on GitHub. Installing it takes about a minute.

  1. Download the APK on your phone: opensolr-mail.apk, the latest release.
  2. Allow the install. Android asks once whether your browser may install apps. Allow it for this install.
  3. Open Opensolr Mail and sign in to Fastmail. See signing in.
  4. Allow notifications when Android asks, so new mail can reach you.
01 · Verifying the download

Every release is signed with the same key. To check an APK before installing it, on a computer with the Android build tools:

apksigner verify --print-certs opensolr-mail.apk

The SHA-256 digest of the signer certificate must be:

2c044aa14fa3a28a4f6b66e408b5d393635bea30dc2d626a449f63ee5c7ca9c0
02 · Updating

The app looks at the latest release on GitHub once a day. When a newer one exists, Settings → Updates shows what is new and an Update to X button. The app downloads the new APK itself, checks that it carries the same signature and is really newer, and hands it to Android’s installer. Nothing is installed without you tapping the button.

  • The first time, Android asks you to allow installs from Opensolr Mail. Allow it, come back and tap the button again.
  • Check for updates in the same place asks GitHub on the spot.
  • A copy installed from Google Play is updated by Google Play: the button opens its Play page instead.
03 · Uninstalling

Uninstalling removes the app and everything it kept on the phone. Your mail stays in Fastmail. If you connected Opensolr, the mail index stays in your Opensolr account; delete it from the control panel if you no longer want it.

Opensolr Mail is open source and MIT licensed. Questions about your Opensolr account, index or plan go to opensolr.com/contact; questions about the app itself belong on GitHub.

Opensolr Mail Documentation