Skip to content
Open
Changes from 2 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
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pi-hole

Suggested change
### Option 1: You are using pihole
### Option 1: You are using Pi-hole


When using pihole, you need to whitelist the proper domains in order for the queries to not be intercepted and blocked by pihole.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
When using pihole, you need to whitelist the proper domains in order for the queries to not be intercepted and blocked by pihole.
When using Pi-hole, you need to whitelist the proper domains in order for the queries to not be intercepted and blocked by Pi-hole.

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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Log into your pihole through the admin interface, then click on Domains situated under GROUP MANAGEMENT.
1. Log into your Pi-hole 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:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
4. You can do so by using this command line in your pihole terminal:
4. You can do so by using this command line in your Pi-hole 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.