GrapheneOS

Note

This edition of Jami is maintained by the community and runs on devices running the GrapheneOS operating system.

The Free Software community recommends using Jami with GNU/Linux.

Download and install the GrapheneOS operating system

GrapheneOS can be installed from the GrapheneOS site.

GrapheneOS is the private and secure mobile operating system with Android app compatibility. Developed as a non-profit open-source project.

The GrapheneOS operating system can be used without needing to sign up to an account.

Download and install the F-Droid app store

F-Droid can be installed from the F-Droid site.

F-Droid is the FOSS app distribution ecosystem for Android where user freedom comes first.

The F-Droid app store can be used without needing to sign up to an account.

Download and install Jami

Jami for GrapheneOS can be installed from the F-Droid app store.

1. Ensure that the device allows installation from unknown sources by going to Settings → Security → Install unknown apps and enabling it for the F-Droid app.

2. Download and install the F-Droid app from its official website or through the GrapheneOS app store.

3. Once F-Droid is installed, open it and search for Jami.

4. Install the Jami application from the search results.

Important

If a device has multiple user profiles, ensure that the F-Droid app version is consistent across all profiles to avoid installation errors due to version mismatches.

Notifications

Set up notifications either without or with a distributor application.

Notifications without a distributor application (recommended)

Enable “Local DHT node”

1. Open the Jami app.

2. Tap the ⋮ (vertical ellipsis) menu at the top right.

3. Tap the App Settings option.

4. Under the Connectivity heading, tap the Connectivity mode option.

5. Tap the Local DHT node option.

6. Tap the OK button.

Enable notifications

1. Open the GrapheneOS Settings app.

2. Tap the Apps option.

3. Tap the Jami app.

4. Tap the Permissions option.

5. Tap the Notifications option.

6. Enable the All Jami notifications toggle.

7. Expand the Background service option.

8. Enable the All ‘Background service’ notifications toggle.

9. Enable the Background service toggle.

10. Tap the Background service option.

11. Enable the Default option.

Notifications with a distributor application (alternative)

See also

A distributor application may be required to receive notifications and distribute them to other applications.

Notifications for Jami will not arrive if Jami is set up with a distributor application that is down.

For more information, click here to visit the Introducing UnifiedPush support in Jami article.

The ntfy (pronounced “notify”) UnifiedPush distributor application can be downloaded and installed from the F-Droid app store.

ntfy (pronounced “notify”) is an open-source push notification service that can be used as a UnifiedPush distributor.

The ntfy service can be used with the default server without needing to sign up with an account.