Notification Debugging - Client Side

This page is based on the legacy notifier integration. It is (and will remain) functional, but for future updates, it's advisable to switch to the new integration.

The info on this page is focussed on making sure notifications work on the client side: HASS.Agent on your PC. Use Notification Debugging - HA Side to debug on Home Assistant's side.

If it still doesn't work after following all below steps, ask for help on Discord or open a Github Ticket.

1. Firewall Rule and Port Reservation

Your PC needs to be able to accept messages from Home Assistant. Normally, your PC's closed for the 'outside world', so we need to allow add an exception.

This is done for you during onboarding, however, you can always execute these steps again by going to Configuration -> Notifications and click execute port reservation.

You can check whether HASS.Agent can be reached by going to this URL on another device on the same network (for instance your smartphone, when it's connected to WiFi):


Make sure to change {hass_agent_ip} to the IP of the PC where HASS.Agent's installed.

If HASS.Agent is configured and the firewall rule's active, you'll see: HASS.Agent Active. If not, something is blocking access to HASS.Agent. Perhaps your using a 3rd party firewall (most paid antivirus have them these days). If that's the case, consult its documentation to see how you can allow an exception for port 5115 and/or HASS.Agent.exe.

2. Windows Notifications Settings

Windows manages which notifications are allowed and when. Usually HASS.Agent is allowed by default. If not, notifications aren't shown, even when you've correctly configured Home Assistant.

For starters, make sure the HASS.Agent icon is shown next to the clock in your taskbar, and not in the overflow message. After you've done this, you can show a test notification by going to Configuration -> Notifications and click show test notification.

Did the notification popup? Great! If not, go to Windows' (new) configuration page and make sure you've enabled Notification access or Notifications, depending on your Windows version:



On that same page, make sure HASS.Agent has its checkbox set to On:


Optionally, click on HASS.Agent instead of the checkbox, and make sure its settings are as follows:


Depending on your Windows version, you may also need to make sure that the Action Center system icon is enabled:


Important: if you have focus assist active, you need to add HASS.Agent to the Priority list (thanks @jrnhrmn):

How to Customize Focus Assist Priority List in Windows 10

When you've done all this, try the show test notification button again in HASS.Agent.

Did the notification show? Great, you can now finish setting up in Home Assistant. If not, continue below.

3. Obscure Windows configurations

There have been a few reports of users which had to change weird Windows settings before it worked. For starters, if you're using privacy tools like o&o shutup or decrapifier (great tools by the way!), make sure they're not set to block notifications.

Sometimes, when telemetry is disabled, it also disables notifications. You can temporarily reenable it with the following Powershell command:

Remove-ItemProperty -Path "HKLM:\Software\Policies\Microsoft\Windows\DataCollection" -Name "AllowTelemetry"

When everything's working, feel free to disable telemetry once again.

The following links may (or may not) help in further debugging: