TerraLyra
TerraLyra / Get started

GET STARTED

Bring IGNIS into Home Assistant.

Start with HACS, then choose the places you want to monitor. Public sources are assigned where coverage allows.

  1. 01

    Add the custom repository

    Open HACS, choose Custom repositories from its menu and add the repository below. Select Integration as the category.

    Repository URL
    https://github.com/TerraLyra/ha-ignis
  2. 02

    Install and restart

    Find TerraLyra IGNIS in HACS, download it and restart Home Assistant.

  3. 03

    Add TerraLyra IGNIS

    Go to Settings → Devices & services → Add integration, then search for TerraLyra IGNIS.

  4. 04

    Choose your monitored places

    Keep Home as the initial location or add named locations in the integration options. Set the monitoring radius for each place.

  5. 05

    Add optional source credentials

    Public GOES and Sentinel-3 sources are assigned automatically where relevant. Add LSA SAF credentials for compatible MTG / MSG-IODC coverage, or enable NASA FIRMS with your own MAP_KEY.

Add a map to your dashboard.

Add a Map card and select the terralyra_ignis geolocation source, or use this example in the card editor. Markers appear when recent incidents are available.

Map card · YAML
type: map
geo_location_sources:
  - source: terralyra_ignis
    label_mode: icon
hours_to_show: 24

Make an update your own.

Use the new-incident event in an automation. Replace the example notification action with the notification service for your device.

Notification example · YAML
alias: IGNIS — new fire notification
triggers:
  - trigger: event
    event_type: terralyra_ignis_new_fire
actions:
  - action: notify.mobile_app_your_phone
    data:
      title: "{{ trigger.event.data.notification_title }}"
      message: "{{ trigger.event.data.notification_message }}"
mode: queued

Coming from the earlier TerraLyra integration?

The move to the terralyra_ignis domain requires a migration. Read the checklist before removing the older integration or changing existing dashboards and automations.

Read the migration checklist

Need a hand?

The repository contains the complete setup instructions, troubleshooting notes and current release information.

Open the documentationReport an issue