Follow these instructions if you are in the following situation:

• You have a Zigbee2MQTT network running, you no longer have the stick, and you want to migrate to Connect ZBT-1.

Please note that not all settings can be migrated in this case:

• These steps help migrate the network, meaning you won't have to pair all your devices again with Home Assistant Connect ZBT-1.
• However, some higher-level settings cannot be migrated. Elements such as device names may be lost. There is currently no migration path to transfer all settings.

To migrate an existing Zigbee Home Automation (ZHA) network via Zigbee2MQTT backup

Step 1

Creating a Zigbee2MQTT backup

1. Under Settings > Add-ons, open the Zigbee2MQTT add-on and select Open Web UI.
2. In the Zigbee2MQTT UI, go to Settings > Tools and select Request z2m backup.
   • Result:

     A zip file should now be downloaded into your Downloads folder.

Step 2

Unzipping the backup folder

• In your Downloads folder, unzip the z2m-backup file.
  • Info:

    It should contain a coordinator_backup.json file.

Step 3

Stopping the Zigbee2MQTT add-on

• Under Settings > Add-ons, in the Zigbee2MQTT add-on, select Stop.
• Zigbee2MQTT uses the MQTT discovery feature to make the Zigbee devices available in Home Assistant. After removing the Zigbee2MQTT add-on, the devices are still present in Home Assistant since the MQTT broker is still holding on to the MQTT discovery messages.
• It is recommended to remove these stale devices from the MQTT broker (see next steps).

Step 4

Removing Zigbee2MQTT devices (option 1)

• If you don't use MQTT outside of z2m, you can delete the Mosquito Broker integration.
• Under Settings > Devices & services, select the Mosquitto broker integration.
• Select the three dots and in the dropdown menu, select Delete.

Step 5

Removing Zigbee2MQTT devices (option 2)

1. If you don't want to delete the Mosquito Broker integration, you can remove the devices from the MQTT network.
2. In the integration card, select Devices, under Device info, select Delete.
3. Repeat this for every device.

Step 6

Plugging the extension cable into Connect ZBT-1

Notice

USB 3.0 ports and USB 3.0 drives can cause interference with 2.4 GHz protocols, including the ones provided by Home Assistant Connect ZBT-1.

- It is important to use the USB extension cable and to position the Home Assistant Connect ZBT-1 away from possible interference sources.

- This video shows the effect of interference.

1. Plug the Home Assistant Connect ZBT-1 into the USB extension cable.
2. Plug the extension cable into your Home Assistant instance.
3. If you are using the standalone Home Assistant Container installation method, make sure Connect ZBT-1 is mapped to the container.

Step 7

Locating the Connect ZBT-1 integration

1. Go to Settings > Devices & services.
2. Connect ZBT-1 should now have been discovered.
3. Select Configure.

Step 8

Uploading a manual backup

• In the Network Formation dialog, select Upload a manual backup.

Step 9

• In your Downloads folder, select the coordinator_backup.json file.

Step 10

Submit the backup json file

• Make sure the coordinator_backup.json file is selected and select submit.

Step 11

Assigning coordinator to area

• Assign the coordinator to an area and select Finish.
• Info:

  You won't be able to control the devices until they rejoin the network. Normally, they join within one hour. You may be able to accelerate that process by power-cycling the device.

Step 12

Reconfiguring automations and dashboards

• Info:

  All migrated devices have new entity IDs. This means you will need to manually reconfigure automations and dashboard cards.
• Info:

  The names that you manually assigned to your devices won't have been migrated. You will have to rename the devices again.