Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions docs/troubleshooting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -174,4 +174,36 @@ This can happen if you have a new installation of Jellyfin/Emby or if you have c

This process should restore your admin privileges while preserving your settings.

## Failed to enable web push notifications

### Option 1: You are using pihole

When using pihole, you need to whitelist the proper domains in order for the queries to not be intercepted and blocked by pihole.
If you are using a chromium based browser (eg: Chrome, Brave, Edge...), the domain you need to whitelist is `fcm.googleapis.com`
If you are using Firefox, the domain you need to whitelist is `push.services.mozilla.com`

1. Log into your pihole through the admin interface, then click on Domains situated under GROUP MANAGEMENT.
2. Add the domain corresponding to your browser in the `Domain to be added` field and then click on Add to allowed domains.
3. Now in order for those changes to be used you need to flush your current dns cache.
4. You can do so by using this command line in your pihole terminal:
```bash
pihole restartdns
```
If this command fails (which is unlikely), use this equivalent:
```bash
pihole pihole -f && pihole restartdns
```
5. Then restart your serr instance and try to enable the web push notifications again.


### Option 2: You are using Brave browser

Brave is a "De-Googled" browser. So by default or if you refused a prompt in the past, it cuts the access to the FCM (Firebase Cloud Messaging) service, whish is mandatory for the web push notifications on Chromium based browsers.

1. Open Brave and paste this address in the url bar: `brave://settings/privacy`
2. Look for the option: "Use Google services for push messaging"
3. Activate this option
4. Relaunch Brave completly
5. You should now see the notifications prompt appearing instead of an error message.

If you still encounter issues, please reach out on our support channels.
Loading