# Installation

# Installation

# Installation

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

* 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**

 ![](https://docs.everythingsmart.io/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2U1MTYzNjNkLThhMWItNDI0Zi1hOTk5LTI0ZDFmMDUxZDNhZi9kMGFiZWI1Yy05MTFiLTRhZTMtOGFhYy03NjhkMzlhMzI5ZTAvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTM2ODExMDAsImV4cCI6MTc5Mzc2NzUwMH0.B7pZy2gL8TPu-ekPKn64iCY98BEC5wcrb6SfaTBeyoQ " =754x786")

### 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

 ![](https://docs.everythingsmart.io/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2U1MTYzNjNkLThhMWItNDI0Zi1hOTk5LTI0ZDFmMDUxZDNhZi9hN2IxN2YzOC1hMTMzLTRkOGYtOGViMi03ZWIwNDJiYzhjNWQvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTM2ODExMDAsImV4cCI6MTc5Mzc2NzUwMH0.QYp2zuKnuVlbba7IXIOmUjexlXzIIXszJ8d4M1dFuK8 " =624x216")

### 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

 ![](https://docs.everythingsmart.io/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2U1MTYzNjNkLThhMWItNDI0Zi1hOTk5LTI0ZDFmMDUxZDNhZi9jMTc3NWI0Ni1hNDdjLTRkNzQtOTU0My0zNTQ0ODQ1NDU4YzAvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTM2ODExMDAsImV4cCI6MTc5Mzc2NzUwMH0.aT_jMUCTvhZmK4f0C8Cin4X2FpDljSEVmVkhFINwB-k " =1568x938")

**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:

```yaml
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

```bash
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:

```bash
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

* [Setup Wizard](/doc/12eba20b-11c3-4451-a484-69636ea2b213) - Configure your first device

---

**Documents**

- [EP1 vs EPL: Which Sensor is Right for You?](https://docs.everythingsmart.io/s/products/doc/ep1-vs-epl-which-sensor-is-right-for-you-5B3RxiY3Kp)
- [Everything Presence One (EP1)](https://docs.everythingsmart.io/s/products/doc/everything-presence-one-ep1-3R178yZSUP)
- [Everything Presence Pro](https://docs.everythingsmart.io/s/products/doc/everything-presence-pro-nh3fIXmow9)
- [Everything Presence Lite (EPL)](https://docs.everythingsmart.io/s/products/doc/everything-presence-lite-epl-ZVnBzYzuX2)
- [Zone Configurator](https://docs.everythingsmart.io/s/products/doc/zone-configurator-93b9scGsa2)
- [Knowledge Base Articles](https://docs.everythingsmart.io/s/products/doc/knowledge-base-articles-KnRRmk4zvt)