Skip to content

Conversation

@tirrorex
Copy link

Add potential fixes for users who fail to enable their web push notifications

Description

Update troubleshooting documentation for users who have troubles with the web push notifications, due to pihole or Brave browser.

To-Dos

  • Disclosed any use of AI (see our policy)
  • Successful build pnpm build
  • Translation keys pnpm i18n:extract
  • Database migration (if required)

Issues Fixed or Closed

  • Fixes #XXXX

Add potential fixes for users who fail to enable their web push notifications
@tirrorex tirrorex requested a review from a team as a code owner November 22, 2025 22:48
@0xSysR3ll 0xSysR3ll changed the title Update troubleshooting.mdx docs: add webpush related troubleshooting steps Nov 22, 2025
Modify appName syntax for better coding norm

Co-authored-by: Gauthier <[email protected]>

## 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


### 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.
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.

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:
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:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants