Push Notifications

Browser notifications report ticket events while Fesk is in the background.

Enabling push notifications

1. Go to Settings → Notifications.
2. Toggle Desktop notifications on.
3. Your browser will ask for notification permission, click Allow.

Fesk then registers a push subscription for the browser so it can receive notifications in the background.

If you've previously blocked notifications for this site, the toggle won't work and a hint explains how to reset the permission in your browser settings.

What triggers a push notification?

The same events controlled by the toggles on the notifications settings page:

| Event | Push | |-------|------| | Ticket assigned to you | ✓ | | New comment on your ticket | ✓ | | Ticket updated | ✓ | | @mentioned | ✓ |

Push notifications respect your individual event preferences. Turning off "New comment" in the preference toggles prevents both in-app and push notifications for that event.

Managing subscriptions

Each browser/device holds its own push subscription. If you sign in on a new laptop, enable desktop notifications there separately, it's per-device.

• Disabling: toggle desktop notifications off in Settings → Notifications. The subscription is removed from the server immediately.
• Clearing browser data: if you clear site data, the subscription is lost. The next time you open Settings, Fesk re-syncs automatically if desktop notifications are still enabled and permission is granted.
• Stale subscriptions: the server prunes subscriptions that are no longer reachable (e.g. browser uninstalled, push service expired) on the next delivery attempt.

Requirements

• A browser that supports Service Workers and the Push API (Chrome, Edge, Firefox, Safari 16.4+).
• The page must be served over HTTPS (localhost is exempt during development).
• VAPID keys must be configured server-side by your administrator. If push is not available, the settings toggle will be hidden or disabled.

Troubleshooting

Toggle reverts immediately You've denied notification permission for this site. In most browsers: click the lock icon in the address bar → Site settings → Reset or allow notifications, then reload the page.

Notifications stopped arriving The push subscription may have expired. Toggle desktop notifications off and back on, Fesk re-subscribes automatically.

No toggle visible at all Push notifications require VAPID configuration on the server side. Contact your administrator.