# Using Unified Push for Notifications

Unified Push is an open-source protocol that enables users to choose how they receive push notifications, breaking the dependency on proprietary services. It empowers users by giving them control over their notifications, promoting privacy, and allowing for a more decentralized and customizable notification experience.

Unified Push can be self-hosted, or can be used with third-party "distributors". You can learn more about Unified Push and common distributors here:

{% embed url="<https://unifiedpush.org/>" %}

Once Unified Push is set up, you can configure your BlueBubbles Server with a new Webhook to send notifications/messages to your device.

## Recommended Set Up

Since Unified Push is essentially just a protocol, there can and will be many distributors that support it. You just have to choose one that works best for you. In our recommended setup, we will be using **ntfy.sh** as our provider. It is a free and easy to use service that can be used directly with the BlueBubbles App (v1.15.0+).

1. Ensure you have the BlueBubbles App v1.15.0 or newer installed
2. Install the ntfy.sh app
   1. Google Play: <https://play.google.com/store/apps/details?id=io.heckel.ntfy>
   2. F-Droid: <https://f-droid.org/en/packages/io.heckel.ntfy/>
3. Open the nfty.sh app and allow notification permissions
4. Open the `Settings` page in the BlueBubbles App
5. Navigate to the `Notification Providers` settings page and open the `Unified Push` configuration.
6. Enable Unified Push
   1. Within a few seconds, you should see an `ntfy.sh` URL generated below the toggle
7. Switch to your BlueBubbles Server (Mac)
8. Open the `API & Webhooks` tab
9. Click `Manage` -> `Add New Webhook`
10. Copy/Paste the URL provided in the BlueBubbles App into the new webhook popup
11. Enable the webhook to for `All Events`
12. Save the Webhook

**Now, when you are not actively using the BlueBubbles App, you should still receive notifications via Unified Push + ntfy.sh**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bluebubbles.app/client/usage-guides/using-unified-push-for-notifications.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.