# zigbee2mqtt/hassio-zigbee2mqtt architecture

> Architecture diagram of the GitHub repository zigbee2mqtt/hassio-zigbee2mqtt, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zigbee2mqtt/hassio-zigbee2mqtt
- Repository: https://github.com/zigbee2mqtt/hassio-zigbee2mqtt

## Overview

This repository packages Zigbee2MQTT as Home Assistant apps, rather than implementing Zigbee2MQTT itself. The documented user workflow is to add the app repository, install the stable or Edge variant, configure the adapter and other settings through Home Assistant, and start the app to reach the Zigbee2MQTT frontend. The stable and Edge variants are represented by their configuration files. Source excerpts were unavailable, so relationships are limited to those explicitly described in the README; the tree alone does not establish how the proxy or shared container files participate at runtime.

Main entry points: [`zigbee2mqtt/config.json`](https://github.com/zigbee2mqtt/hassio-zigbee2mqtt/blob/master/zigbee2mqtt/config.json) (Stable app), [`zigbee2mqtt-edge/config.json`](https://github.com/zigbee2mqtt/hassio-zigbee2mqtt/blob/master/zigbee2mqtt-edge/config.json) (Edge app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ha["Home Assistant"]
  node_app_repo["App repository"]
end

subgraph group_apps["Zigbee2MQTT Apps"]
  node_stable["Stable app<br/>[config.json]"]
  node_edge["Edge app<br/>[config.json]"]
end

node_user(("Home Assistant user"))
node_z2m["Zigbee2MQTT runtime"]
node_onboarding["Onboarding UI"]
node_frontend["Zigbee2MQTT frontend"]

node_user -->|"adds repository"| node_app_repo
node_user -->|"installs app"| node_stable
node_user -->|"installs app"| node_edge
node_stable -->|"opens after start"| node_onboarding
node_user -->|"submits settings"| node_onboarding
node_onboarding -->|"configures startup"| node_z2m
node_z2m -->|"starts frontend"| node_frontend

click node_stable "https://github.com/zigbee2mqtt/hassio-zigbee2mqtt/blob/master/zigbee2mqtt/config.json"
click node_edge "https://github.com/zigbee2mqtt/hassio-zigbee2mqtt/blob/master/zigbee2mqtt-edge/config.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app_repo,node_user,node_onboarding,node_frontend toneBlue
class node_stable,node_edge toneAmber
class node_z2m toneIndigo
```

## Components

### Home Assistant

- **App repository**

### Zigbee2MQTT Apps

- [Stable app](https://github.com/zigbee2mqtt/hassio-zigbee2mqtt/blob/master/zigbee2mqtt/config.json): `zigbee2mqtt/config.json`
- [Edge app](https://github.com/zigbee2mqtt/hassio-zigbee2mqtt/blob/master/zigbee2mqtt-edge/config.json): `zigbee2mqtt-edge/config.json`

### Other components

- **Home Assistant user**
- **Zigbee2MQTT runtime**
- **Onboarding UI**
- **Zigbee2MQTT frontend**

## Connections

- Home Assistant user → App repository: adds repository (evidence: `README.md`)
- Home Assistant user → Stable app: installs app (evidence: `README.md`)
- Home Assistant user → Edge app: installs app (evidence: `README.md`)
- Stable app → Onboarding UI: opens after start (evidence: `README.md`)
- Home Assistant user → Onboarding UI: submits settings (evidence: `README.md`)
- Onboarding UI → Zigbee2MQTT runtime: configures startup (evidence: `README.md`)
- Zigbee2MQTT runtime → Zigbee2MQTT frontend: starts frontend (evidence: `README.md`)
