Web Push Notification Agent plugin for Unraid

 

This plugin adds browser push notifications to your Unraid server. Works like other notification agents.

 

Prerequisites:

• Unraid version 6.12+
• WebUI over HTTPS connection with valid certificate.
• Your server must have access to internet (notifications will be send to your devices through push service. Both your Unraid and devices must have access to internet. No need to keep Unraid WebUI open).

 

Usage:

1. Browse the Unraid notifications settings page (just after SMTP Settings) with the device you want to receive notifications on.
2. Click on "Request permission and register" button to allow notifications on your current browser.

 

On desktop:

Your browser must be open to receive notifications, otherwise they will be pending until opened.

On mobile devices:

To enable push notifications on Apple iPhone/iPad, add Unraid notifications settings page to the Home Screen.

Notification may not arrive instantly. It will depend on several factors: OS deep sleep, power management profile, frozen application when idle, battery level, network usage, ... and the way notifications are implemented (see this comment for Android on Chromium Issue Tracker).

 

Browser compatibility:

Works on:

• Desktop
  • Chromium based
    • Chrome 50+
    • Vivaldi 6+
    • Edge 17+
    • Opera 42+
  • Firefox 44+
  • Safari 16.4+
• Mobile (Android)
  • Chromium based
    • Chrome 124+
    • Vivaldi 6+
    • Opera 80+ (not Opera Mini)
    • Samsung Internet 24+
  • Firefox 125+

 

Not tested on:

• Mobile (Apple)
  • Safari

 

I don't have access to iPhone/iPad devices, so I can't test on them. Would be great if you could report any issues with these devices.

 

https://github.com/Peuuuur-Noel/unraid-web-push-notification

Edited June 25, 20242 yr by Peuuuur Noel

is this just another way to get notifications than what what is already built in to unraid?

Yes, to use browser built in notification system.

Mostly for people who don't want to use third party apps like Discord, Slack, Telegram, etc.

AHH good job!

Is there a way to not have this force HTTPS port? I use CF tunnel, zero trust, and a TLD to reach my server so it has https when accessed remotely but not locally. 

No, PushAPI only works over HTTPS connections because your browser send key and endpoint to the server. These data must not be retrieved by anyone otherwise you could get easily spammed.

If you have HTTPS when accessed remotely, you can register your browser from this way. No need to be on the same network or locally to receive notification or register your browser.

Edited July 10, 20241 yr by Peuuuur Noel

@Peuuuur NoelWhat I think they were saying is that the plugin won't work when the unraid UI is accessed on port 80, even through a local proxy like nginx with a certificate.

 

Also, this works fine on iOS provided the web ui is added to the home screen.

 

This should honestly be part of the core unraid OS.