Setup browser push notifications

Most modern web browsers like Mozilla Firefox, Google Chrome and Microsoft Edge provide a Notification API.

openITCOCKPIT can use this API to send host and services alerts to your browser.



  • Modern web browser
  • Manually grant permissions in Browser
  • openITCOCKPIT needs to be open in one browser tab (Browser window can be in the background or task bar)
  • Contact needs to be assigned to a user.
  • Push notifications to browser needs to be enabled in contact configuration
  • push_notification.service service needs to be running on the openITCOCKPIT server

Setup push notifications

Browser permissions

Before openITCOCKPIT can send push notifications to your web browser, you need to manually grant permissions. This is a security feature of all browsers, to avoid that random websites will send you spam messages. You can always grant or revoke the notification permission whenever you want.

In this example, we show the process using Mozilla Firefox.

Grant permissions

Click on the notification icon in the browser address bar and press "Allow notifications"


Create or edit an existing contact

To recive push notifications, you need to link your user account with a contact of the monitoring engine. By default, all contacts don't belong to any user that exists in the openITCOCKPIT interface.

Go to Objects Contacts and select the contact you want to enable Browser push notifications for.

Assign your user to the contact and pick the checkboxes for Push notifications to browser

You can also combine different notification commands like notify by email and browser notifications etc.

After you edited the contact, please make sure to Refresh monitoring configuration.

Notification examples

Every notification will container an icon for host or services. The current state is represented by the color of the icon. By clicking on the notification, a new browser tab will navigate you to the corresponding host or service. The notification will disappear automatically after a few seconds.

Notice: The notification design is provided by the operating system. Notifications may be look different on different operating systems. There is no way to use a different style for the notifications.


  • Try to reload the page: Ctrl + R or Cmd + R

  • Connectivity issues. If your browser lost connection to the openITCOCKPIT server, it could happen that you will not receive push notifications. Refresh the page to resolve the issue.

  • push_notification service not running. This background daemon needs to be up and running. Also your web server configuration or reverse proxy configuration could be cause an issue. You can check the developer tools of your browser, to check if there is a connectivity issue: Issue (push_notification not running):

Successfully connected:

If the push_notification service is not running, the debug page of openITCOCKPIT and the System health overview will show a warning.

  • Some applications may suppress browser notifications. We notice this behavior on Microsoft Windows 7 in combination with Snipping Tool. A refresh of the openITCOCKPIT page resolved the issue.

  • macOS maybe running in Do Not Disturb mode. This could also automatically happen if you connect a projector or TV screen.

  • Too many notifications could also result in a suppressing issue. Try to reduce the amount of receive push notifications.

  • Check if an update for your web browser is available.

  • Does the notifications work in Internet Explorer? No.