Everything Smart

Installation

Install Zone Configurator and prepare it for use with your Everything Presence devices and Home Assistant setup.


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

Choose Your Installation Method

Home Assistant Type Installation Method
Home Assistant OS Add-on (recommended)
Home Assistant Supervised Add-on (recommended)
Home Assistant Core Docker Container
Home Assistant Container Docker Container

Add-on Installation (Home Assistant OS / Supervised)

Prerequisites

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
  1. Click Add then Close

Step 1: Add the Repository — illustration 1

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 2: Install the Add-on — illustration 1

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

Step 3: Start the Add-on — illustration 1

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

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:

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

Issue Solution
Repository not appearing Refresh the page and check the URL is correct
Add-on won't start Check the add-on logs for errors
Sidebar icon missing Ensure "Show in sidebar" is enabled in add-on settings
Docker: Connection refused Verify HA_BASE_URL is correct and Home Assistant is accessible
Docker: 401 Unauthorized Check your long-lived access token is correct
Docker: Container won't start Check logs with docker logs zone-configurator

Next Steps