I enabled push but never received the test notification.

Check the operating system's notification permission for your browser. The browser permission and the OS permission are separate and both must allow notifications. On macOS, System Settings, Notifications, your browser, Allow Notifications must be on.

I received the test notification but real alerts are not arriving.

The push channel is not in the alert path. Confirm the channel is in a notification group and that the group is assigned to the monitor that is firing.

Push used to work and then stopped.

You most likely cleared browser data. The push subscription lives in the browser and clearing site data deletes it. Delete the push channel in Drumbeats and enable it again.

I am on iOS Safari and push does not work.

iOS Safari only delivers push to a web app opened from the Home Screen. Tap Share, then Add to Home Screen, open Drumbeats from that icon, then enable push.

Guide

Push troubleshooting

Every reason a browser push alert does not arrive, in the order worth checking.

Browser push needs permission at two separate layers, the browser and the operating system, and it fails silently when either one says no.

Start here:

Symptom	Go to
The setup test never arrived	Check the OS permission. This is the usual cause
The test arrived, real alerts do not	Check the alert path
Push worked before and stopped	Restore a lost subscription
Nothing above fits	Check the service worker

Check the browser permission#

Open Drumbeats in the browser where you enabled push.
Click the lock or site-settings icon in the address bar.
Find Notifications in the permission list.
Confirm it reads Allow, not Block and not Ask.

If it reads Block, reset it:

Chrome and Edge. Open chrome://settings/content/notifications or edge://settings/content/notifications. Find drumbeats.io under Not allowed, open its menu, choose Allow. Reload Drumbeats and enable push again.

Firefox. Open about:preferences#privacy, go to Permissions → Notifications → Settings, set drumbeats.io to Allow, reload, enable push again.

Safari on macOS. Open Safari → Settings → Websites → Notifications, set drumbeats.io to Allow, reload, enable push again.

Check the OS permission#

The browser can say yes while the operating system says no. This is the single most common cause of "push is set up but nothing arrives".

macOS. Open System Settings → Notifications, find your browser in the app list, confirm Allow Notifications is on. Then click Send Test on the push channel.

Windows. Open Settings → System → Notifications. Confirm the master toggle is on, then scroll to the app list and confirm your browser is on.

iOS, Safari 16.4 and later. Push only works for a web app installed to the Home Screen. Open Drumbeats in Safari, tap Share → Add to Home Screen, open Drumbeats from the new icon, then enable push from the channels page. If it still fails, open Settings → Notifications and find the web app, then turn Allow Notifications on.

Android, Chrome. Open Settings → Apps & notifications → Chrome → Notifications and confirm it is enabled. In Chrome, open Site settings → Notifications and confirm drumbeats.io is in the allowed list.

Linux. Notification handling varies by desktop environment. Check your system notification settings, for example GNOME Settings → Notifications, and confirm the browser is allowed.

Turn off Do Not Disturb#

Do Not Disturb and Focus modes suppress every notification, Drumbeats included, and nothing about this is visible to Drumbeats. The alert is sent, accepted, and then dropped by the operating system.

On macOS, look for the moon icon in the menu bar. On Windows, check Focus Assist in the notification area. On iOS and Android, check the Do Not Disturb toggle in Control Center or Quick Settings.

Restore a lost subscription#

The push subscription lives in the browser. Clearing cookies, cache, or site data deletes it, and Drumbeats then has no route to that browser at all.

You will see the channel still listed in Drumbeats while no alerts arrive, sometimes with a warning that the subscription is missing.

Open Settings → Notification Channels.
Delete the existing push channel.
Click Enable on This Device to create a fresh subscription.
Click Send Test to confirm.

Check the service worker#

Push depends on the Drumbeats service worker being registered and active. A broken one fails silently.

In Chrome or Edge, open DevTools, go to Application → Service Workers, and confirm a worker for drumbeats.io shows as activated and running.

If it is missing or erroring, open Application → Storage → Clear site data, reload the page, and enable push again from the channels page.

Check the alert path#

A test push proves the device is reachable. It proves nothing about routing.

Open the monitor that should be firing and check its Notifications tab. It needs a group assigned, or the push channel added directly.
Open that group and confirm the push channel is actually in it.
Trigger a real failure with curl https://api.drumbeats.io/v1/ping/<monitor-id>/failure and watch.

If other channels in the group received that alert and push did not, the problem is on the device. Work back up this page.

Still stuck#

Email support@drumbeats.io with your operating system, browser version, and any warning shown on the channels page.

Next#

Channels for the other seven channel types, several of which make better backups than push. Support for triage on everything else.