jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-24 01:37:23 +00:00
Code Issues Packages Projects Releases Wiki Activity

Z-Wave: update migration steps to reflect current SW (#40102)

Browse Source
This commit is contained in:
c0ffeeca7 2025-07-22 17:34:14 +02:00 committed by GitHub
parent a5598cb9a3
commit 92c9853717
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 18 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
source/_integrations/zwave_js.markdown
View File

@ -174,6 +174,10 @@ Do this before using the device with another adapter, or when you don't use the
Do this if you have an existing Z-Wave network and want to replace its adapter with a new adapter. The Z-Wave integration with all its entities will stay in Home Assistant. The new adapter is added to Home Assistant and paired with the existing network. Do this if you have an existing Z-Wave network and want to replace its adapter with a new adapter. The Z-Wave integration with all its entities will stay in Home Assistant. The new adapter is added to Home Assistant and paired with the existing network.
{% tip %}
You cannot run two Z-Wave adapters simultaneously using the same add-on. If you only run one add-on, you need to migrate the network. If you want to run two adapters, you would need to install another add-on, such as Z-Wave JS UI.
{% endtip %}
### Prerequisites ### Prerequisites
- Administrator rights in Home Assistant - Administrator rights in Home Assistant
@ -184,18 +188,20 @@ Do this if you have an existing Z-Wave network and want to replace its adapter w
### To migrate a Z-Wave network to a new adapter ### To migrate a Z-Wave network to a new adapter
1. In Home Assistant, go to {% my integrations title="**Settings** > **Devices & services**" %}. 1. In Home Assistant, go to {% my integrations title="**Settings** > **Devices & services**" %}.
2. Select the **Z-Wave** integration. 2. Connect your new adapter.
- Then, select the cogwheel {% icon "mdi:cog-outline" %}. - Plug in your new adapter.
3. Under **Backup and restore**, select **Migrate adapter**. - **Result**: The adapter should be discovered and show up in the **Discovered section**.
4. Select **Migrate to a new adapter**. - Select **Add** and follow the instructions on screen.
- **Troubleshooting**: Not all devices can be discovered automatically. If your device does not show up, follow these steps:
- To confirm, select **Submit**. 1. Select the **Z-Wave** integration.
- **Info**: This will initiate a backup of the network information. 2. Then, select the cogwheel {% icon "mdi:cog-outline" %}.
5. When the **Unplug your adapter** dialog shows up, unplug your old adapter. 3. Under **Backup and restore**, select **Migrate adapter**.
- Connect the new adapter. 4. Select **Migrate to a new adapter**.
- Confirm that you connected the new adapter by selecting **Submit**. - To confirm, select **Submit**.
6. Follow the steps on screen. 3. When the **Unplug your adapter** dialog shows up, unplug your old adapter.
7. Once the migration has completed, check if you want to rename the adapter. If you have previously changed the name, the new adapter might keep the name of the old adapter. - It is important to remove the old device now, as it might interfere with the new one. Even though it might not throw an error immediately, it might cause issues.
4. Follow the steps on screen.
5. Once the migration has completed, check if you want to rename the adapter. If you have previously changed the name, the new adapter might keep the name of the old adapter.
- In the top-left corner, select the back button to go back to the integration page. - In the top-left corner, select the back button to go back to the integration page.
- In the list of devices, check the device name. - In the list of devices, check the device name.
- To change the device name, select the {% icon "mdi:pencil" %} button. - To change the device name, select the {% icon "mdi:pencil" %} button.