Get Element Android Notifications Without Google Services

For reliable Element Android alerts without Google services, install the F-Droid build of Element and a UnifiedPush distributor such as ntfy, then select that distributor in Element. On a self-hosted Matrix server, the notification route must also reach a compatible push gateway—ntfy provides a Matrix gateway, either through its public service or a server you host. Without a distributor, the F-Droid build can use background polling, but Android may delay that fallback when the app is idle.

Understand the notification path

Matrix push is a chain: Synapse sends a notification request to a push gateway; the gateway relays it to a distributor app on the phone; the distributor wakes Element so it can process the event and show an Android notification. A failure at any link can look like “Element notifications are broken.” Installing a new homeserver does not by itself supply a phone-side push distributor.

Element Android’s project documentation distinguishes its app flavors. The Google Play build uses an embedded FCM distributor by default when no other distributor is selected. The F-Droid build excludes that Google-dependent library; if no compatible distributor is installed, it uses polling. Both flavors support an external UnifiedPush distributor when the feature is enabled and the user opts in. For a phone without Google services, F-Droid plus ntfy is the simplest documented route.

ntfy has two roles in this setup: its server is a Matrix-compatible push gateway, and its Android app is the UnifiedPush distributor. These roles are related but distinct. You can use the public ntfy service for a simpler setup, or operate an ntfy server if you want to control the gateway infrastructure. Self-hosting the Matrix homeserver does not require that you also self-host ntfy.

Set up Element with a UnifiedPush distributor

  1. Install the F-Droid version of Element Android. Use a current build from the F-Droid repository. If you already have Element installed from another source, check the app source and build before changing notification settings; the Play flavor may select FCM by default.
  2. Install ntfy from a source available on your device. The official UnifiedPush guide lists F-Droid and direct download as options. Open ntfy and grant Android notification permission. In ntfy settings, use the default public server for a quick test or enter your own HTTPS ntfy server URL.
  3. Choose ntfy in Element. Sign in to your Matrix account. When Element offers a notification service choice, select ntfy. If you dismissed the prompt or it did not appear, open Element’s notification settings and its notification troubleshooting screen; the exact labels can vary by app release. Make sure the notification service is enabled for the account and that the distributor is selected.
  4. Allow both apps to run in the background. In Android’s app settings, allow notifications for Element and ntfy. Set battery use or background activity to unrestricted for both if your device offers that option. Device makers use different labels and may add their own app-sleep controls, so check the phone’s battery settings if delivery stops only after the screen has been off.

For example, if a Fairphone or a de-Googled Android device receives messages only while Element is open, install the ntfy distributor and select it in Element first. Then test again with Element in the background. If notifications still fail, determine whether ntfy itself receives a test message before changing Synapse settings.

Check the self-hosted push gateway

If you run your own ntfy server, it must be reachable over HTTPS from both Synapse and the phones, and its Matrix gateway must be configured. The current Element guide uses the example endpoint https://ntfy.example.com/_matrix/push/v1/notify. Open the corresponding URL for your domain in a browser; a configured ntfy Matrix gateway should return a response indicating {"unifiedpush":{"gateway":"matrix"}}. Confirm DNS, TLS certificate trust, firewall rules, and the ntfy server’s base-url setting if it does not.

Synapse blocks outbound requests to private IP ranges by default. If your ntfy server is reachable only at a private address, the UnifiedPush troubleshooting guidance recommends allowing the push server’s IP as Synapse sees it. Add only the specific address under the top-level ip_range_whitelist setting in homeserver.yaml, for example:

ip_range_whitelist:
  - '192.168.1.20'

Use your actual gateway address, not this example. This exception allows Synapse to make outbound requests to that address and should be kept as narrow as your network allows. Restart Synapse after changing the configuration. If you already use an HTTP proxy, note that Synapse documents the IP range setting as ignored when a proxy is in use.

Find the failing link with a controlled test

  1. Test the distributor first. Send a test notification to a topic through your ntfy server and confirm it appears on the phone. If not, troubleshoot ntfy connectivity, Android notification permission, or battery restrictions before investigating Matrix.
  2. Run Element’s notification troubleshooter. Its checks can help show whether a distributor is detected and whether Element has registered push. If the test passes at the ntfy layer but not for Matrix events, inspect Synapse logs and confirm that the homeserver can reach the ntfy gateway URL.
  3. Send a Matrix message while Element is not open. Use another client to message the account signed in on the phone. A successful notification confirms the end-to-end route. If it arrives only after reopening Element, check background restrictions and the app’s notification service selection.

Do not treat polling and push as identical. Polling can be useful as a fallback when no distributor is installed, but it may consume more background activity and can be less timely under Android power management. If immediate alerts matter, test with Element closed and the screen off, then adjust the device’s background settings or the push server path based on the failed check.

Official references

Leave a Comment

Get Element Android Notifications Without Google Services

Set up Element Android with UnifiedPush and ntfy, then check the self-hosted Matrix gateway and Android background settings when alerts fail.

Get Nextcloud iPhone Photo Uploads Running in the Background

Get Nextcloud iPhone Photo Uploads Running in the Background

Restore background photo detection by checking Nextcloud upload settings, iOS permissions, battery mode, and the limits of iPhone background scheduling.

Clearer Text in ONLYOFFICE Desktop: Tune Font Hinting on Linux

Clearer Text in ONLYOFFICE Desktop: Tune Font Hinting on Linux

Compare ONLYOFFICE font hinting modes, check zoom and Linux font availability, and verify whether blur is limited to the editor or affects the whole desktop.

Turn a PDF into an Editable DOCX in ONLYOFFICE Desktop

Turn a PDF into an Editable DOCX in ONLYOFFICE Desktop

Convert a PDF locally in ONLYOFFICE Desktop Editors, then review the DOCX for layout changes, scanned pages, and text that needs correction.

Connect ONLYOFFICE Desktop Editors to Your ownCloud Files

Add your ownCloud account to ONLYOFFICE Desktop Editors, understand what the connection enables, and choose between direct access, sync, and browser editing.

Fix ONLYOFFICE Mobile Timeouts by Checking the Server URL

Fix ONLYOFFICE Mobile Timeouts by Checking the Server URL

Use the right portal or WebDAV address, test HTTPS reachability from your phone, and distinguish private-network, TLS, and login problems.

Enable ONLYOFFICE Desktop Plugin Development and Debugging

Enable ONLYOFFICE Desktop Plugin Development and Debugging

Build and test a custom ONLYOFFICE Desktop Editors plugin, install its .plugin archive, and activate developer tools for debugging.

Run Python in Calc Through LibreOffice’s Macro System

Run Python in Calc Through LibreOffice’s Macro System

Make a Python function available in Calc, run it against the open spreadsheet, and troubleshoot missing macros or imports without mixing up LibreOffice and system Python.

Protect Selected Writer Text with a Section Password

Protect Selected Writer Text with a Section Password

Lock a specific passage against routine edits while keeping the rest of a Writer document usable, and learn when file encryption is the better choice.

Make Spreadsheet Text Readable in LibreOffice Calc Dark Mode

Make Spreadsheet Text Readable in LibreOffice Calc Dark Mode

Fix hard-to-see spreadsheet text by checking the theme, cell font color, fills, and conditional formatting in Calc.