Skip to content

Installation

Everything Presence Pro Grid is in HACS's default integration list, so you can install it directly. HACS handles installs and updates the same way as for any other integration. You'll need a working Home Assistant install to add it to.

Prerequisites

  • Home Assistant 2026.5.0 or newer.
  • HACS installed (recommended).

Quick install (My Home Assistant button)

Open your Home Assistant instance and open this repository in HACS.

Click the button and confirm the dialog in your Home Assistant to open the Everything Presence Pro Grid page in HACS. Click Download, then restart Home Assistant.

From the HACS list

  1. Open HACS in the Home Assistant sidebar.
  2. Search for Everything Presence Pro Grid and open it.
  3. Click Download.
  4. Restart Home Assistant.

Installing Everything Presence Pro Grid with HACS.

Install manually

If you can't use HACS:

  1. Download the latest release archive from the Releases page.
  2. Unpack it and copy custom_components/eppgrid/ into your HA config's custom_components/ folder.
  3. Restart Home Assistant.

After installing

  1. Go to Settings → Devices & services → Add integration, search for Everything Presence Pro Grid, and add the entry.
  2. The Everything Presence Pro Grid panel appears in the HA sidebar for administrator users only — Home Assistant hides it from non-admin users. If the panel doesn't show up for you and you are an admin, hard-refresh the HA web UI (Ctrl-F5 / Cmd-Shift-R). Non-admin users can still see EPP Grid entities (zone presence, target positions, environment sensors) on any shared dashboard via the standard Home Assistant entity cards.
  3. The panel starts empty. See Flashing firmware to put Everything Presence Pro Grid firmware on your first device.

After adding your first device, the panel walks you through naming it and assigning an area — see Flashing firmware.

Everything Presence Pro Grid panel in the HA sidebar, empty state — no devices yet.

Troubleshooting

Symptom Likely cause Fix
HACS doesn't list the integration HACS hasn't refreshed its default repository list yet Wait a few minutes and search again, or restart Home Assistant to make HACS refresh its list.
Integration installed but the panel doesn't appear in the HA sidebar Integration entry hasn't been added yet, or you're signed in as a non-admin user Confirm you're signed in as an administrator (the panel is admin-only). Otherwise go to Settings → Devices & services → Add integration and add Everything Presence Pro Grid. If the panel still doesn't appear, hard-refresh the HA web UI (Ctrl-F5 / Cmd-Shift-R).
"Integration update required" banner appears immediately after install Your device firmware is newer than the integration release you've just installed Either update the integration to a newer release in HACS, or downgrade the firmware to match.
Manual install done but panel still not appearing custom_components/eppgrid/ is in the wrong place, or nested one level too deep Verify the eppgrid/ directory sits directly under your HA config's custom_components/ folder, and check HA logs for import errors.

Still stuck? See Troubleshooting for how to open an issue.

Where to next