Home Assistant

Home Assistant notifications

Sentinel can send alert-rule matches to Home Assistant as a custom event, which you can turn into mobile push notifications, automations, TTS, lights, etc.

1) Configure Sentinel server → Home Assistant

Set these environment variables on the Sentinel server (see env.example in the main repo):

• HOME_ASSISTANT_URL: Base URL of your HA instance, e.g. https://homeassistant.local:8123
• HOME_ASSISTANT_ACCESS_TOKEN: Long-lived access token (Home Assistant → Profile → Security)
• HOME_ASSISTANT_EVENT_TYPE (optional): Default is sentinel_alert
• PUBLIC_BASE_URL (recommended): Public URL to your Sentinel dashboard, e.g. https://sentinel.example.com

Then restart the Sentinel server container/service.

What gets sent to Home Assistant

Sentinel fires an event of type HOME_ASSISTANT_EVENT_TYPE with fields including:

• rule_name, channel, agent_id, agent_name, snippet, ts
• dashboard_url (when PUBLIC_BASE_URL is set)
• dashboard_activity_url (when PUBLIC_BASE_URL is set): deep-link to the agent Activity tab and highlight the event time

2) Import the blueprint into Home Assistant

In Home Assistant:

1. Go to Settings → Automations & Scenes → Blueprints
2. Click Import Blueprint
3. Paste this URL:

https://raw.githubusercontent.com/gladsonsam/Sentinel/main/server/src/notify/home_assistant_blueprint.yaml

If your default branch is master, use:

https://raw.githubusercontent.com/gladsonsam/Sentinel/master/server/src/notify/home_assistant_blueprint.yaml

3) Create an automation from the blueprint

1. Create a new automation from the imported blueprint
2. Pick your mobile_app device (Companion app)
3. Optional: customize the title prefix

When an alert rule matches, you should receive a push notification with an Open event action that deep-links to Sentinel.