Installation

Installation

This guide walks you through installing Zone Configurator. Choose the method that matches your Home Assistant installation type.

Choose Your Installation Method

Add-on Installation (Home Assistant OS / Supervised)

Prerequisites

• Home Assistant OS or Supervised installation

• At least one Everything Presence device (Pro, Lite, or One) already set up in Home Assistant

Step 1: Add the Repository

1. In Home Assistant, go to Settings → Add-ons

2. Click the Add-on Store button (bottom right)

3. Click the three dots menu (top right) and select Repositories

4. Add the following repository URL:

https://github.com/EverythingSmartHome/everything-presence-addons

5. Click Add then Close

Step 2: Install the Add-on

1. The add-on store will refresh. Scroll down to find Everything Presence MMWave Configurator

2. Click on the add-on

3. Click Install

4. Wait for the installation to complete

Step 3: Start the Add-on

1. After installation, click Start

2. Enable Show in sidebar for easy access

3. Optionally enable Start on boot to have it run automatically

Port change (v2.0.11): The default app port is now 42069. If you are upgrading from an older version, open the add-on Configuration tab, set port to 42069, then restart the add-on to restore ingress access.

Step 4: Open Zone Configurator

1. Click Zone Configurator in your Home Assistant sidebar

2. The Setup Wizard will launch automatically if this is your first time

Docker Installation (Home Assistant Core / Container)

If you're running Home Assistant Core or Container, you can run Zone Configurator as a standalone Docker container.

Prerequisites

• Docker installed on your system

• Home Assistant running and accessible

• At least one Everything Presence device (Pro, Lite, or One) already set up in Home Assistant

• A Home Assistant long-lived access token

Step 1: Create a Long-Lived Access Token

1. In Home Assistant, click your profile (bottom left of sidebar)

2. Scroll to Long-Lived Access Tokens

3. Click Create Token

4. Give it a name like "Zone Configurator"

5. Copy the token (you won't be able to see it again)

Step 2: Create docker-compose.yaml

Create a docker-compose.yaml file:

services:
  zone-configurator:
    image: everythingsmarthome/everything-presence-mmwave-configurator:latest
    container_name: zone-configurator
    restart: unless-stopped
    ports:
      - "42069:42069"
    environment:
      HA_BASE_URL: "http://YOUR_HA_IP:8123"
      HA_LONG_LIVED_TOKEN: "YOUR_TOKEN_HERE"
    volumes:
      - ./config:/config

Port change (v2.0.11): The default app port is now 42069. To keep the old behavior, set PORT=3000 and map 3000:3000 instead.

Replace:

• YOUR_HA_IP with your Home Assistant IP address or hostname

• YOUR_TOKEN_HERE with the long-lived access token you created

Step 3: Start the Container

docker-compose up -d

Step 4: Access Zone Configurator

Open your browser and go to:

http://YOUR_SERVER_IP:42069

The Setup Wizard will launch automatically if this is your first time.

Updating the Docker Container

To update to the latest version:

docker-compose pull
docker-compose up -d

Troubleshooting Installation

Next Steps

• Setup Wizard - Configure your first device