<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>healthchecks.io | mutschler.dev</title><link>https://mutschler.dev/tag/healthchecks.io/</link><atom:link href="https://mutschler.dev/tag/healthchecks.io/index.xml" rel="self" type="application/rss+xml"/><description>healthchecks.io</description><generator>Wowchemy (https://wowchemy.com)</generator><language>en-us</language><lastBuildDate>Tue, 17 Nov 2026 00:00:00 +0000</lastBuildDate><image><url>https://mutschler.dev/media/icon_hu589851f325050e29bd29c51f9d799271_45964_512x512_fill_lanczos_center_3.png</url><title>healthchecks.io</title><link>https://mutschler.dev/tag/healthchecks.io/</link></image><item><title>Home Assistant OS on a Raspberry Pi 4: clean install and restore from backup</title><link>https://mutschler.dev/linux/raspi-home-assistant-os/</link><pubDate>Tue, 17 Nov 2026 00:00:00 +0000</pubDate><guid>https://mutschler.dev/linux/raspi-home-assistant-os/</guid><description>&lt;p>&lt;em>&lt;strong>Please feel free to raise any comments or issues on the &lt;a href="https://github.com/wmutschl/mutschler.dev" target="_blank" rel="noopener">website&amp;rsquo;s Github repository&lt;/a>.
Pull requests are very much appreciated.&lt;/strong>&lt;/em>
&lt;a href="https://www.buymeacoffee.com/mutschler" target="_blank">&lt;img src="https://cdn.buymeacoffee.com/buttons/v2/default-red.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" >&lt;/a>&lt;/p>
&lt;details class="toc-inpage d-print-none d-xl-none " open>
&lt;summary class="font-weight-bold">Table of Contents&lt;/summary>
&lt;nav id="TableOfContents">
&lt;ul>
&lt;li>&lt;a href="#overview">Overview&lt;/a>&lt;/li>
&lt;li>&lt;a href="#step-0-hardware-and-general-remarks">Step 0: Hardware and general remarks&lt;/a>&lt;/li>
&lt;li>&lt;a href="#step-1-flash-home-assistant-os-onto-the-sd-card">Step 1: Flash Home Assistant OS onto the SD card&lt;/a>
&lt;ul>
&lt;li>&lt;a href="#option-a-raspberry-pi-imager">Option A: Raspberry Pi Imager&lt;/a>&lt;/li>
&lt;li>&lt;a href="#option-b-terminal-on-macos">Option B: Terminal on macOS&lt;/a>&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>&lt;a href="#step-2-first-boot-and-a-fixed-ip-address">Step 2: First boot and a fixed IP address&lt;/a>&lt;/li>
&lt;li>&lt;a href="#step-3-onboarding">Step 3: Onboarding&lt;/a>&lt;/li>
&lt;li>&lt;a href="#step-4-apps">Step 4: Apps&lt;/a>&lt;/li>
&lt;li>&lt;a href="#step-5-zigbee2mqtt-with-the-sonoff-dongle">Step 5: Zigbee2MQTT with the Sonoff dongle&lt;/a>&lt;/li>
&lt;li>&lt;a href="#step-6-encrypted-backups-to-an-smb-share">Step 6: Encrypted backups to an SMB share&lt;/a>&lt;/li>
&lt;li>&lt;a href="#step-7-healthchecksio-heartbeat">Step 7: healthchecks.io heartbeat&lt;/a>&lt;/li>
&lt;li>&lt;a href="#step-8-restore-from-a-backup">Step 8: Restore from a backup&lt;/a>
&lt;ul>
&lt;li>&lt;a href="#what-you-need">What you need&lt;/a>&lt;/li>
&lt;li>&lt;a href="#restore-during-the-onboarding">Restore during the onboarding&lt;/a>&lt;/li>
&lt;li>&lt;a href="#checks-after-the-restore">Checks after the restore&lt;/a>&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>&lt;a href="#step-9-update-the-firmware-of-the-zigbee-dongle">Step 9: Update the firmware of the Zigbee dongle&lt;/a>
&lt;ul>
&lt;li>&lt;a href="#backup-first">Backup first&lt;/a>&lt;/li>
&lt;li>&lt;a href="#stop-zigbee2mqtt">Stop Zigbee2MQTT&lt;/a>&lt;/li>
&lt;li>&lt;a href="#flash-the-firmware-with-the-sonoff-dongle-flasher">Flash the firmware with the SONOFF Dongle Flasher&lt;/a>&lt;/li>
&lt;li>&lt;a href="#put-it-back-and-start-zigbee2mqtt">Put it back and start Zigbee2MQTT&lt;/a>&lt;/li>
&lt;li>&lt;a href="#check-that-it-worked">Check that it worked&lt;/a>&lt;/li>
&lt;/ul>
&lt;/li>
&lt;/ul>
&lt;/nav>
&lt;/details>
&lt;h2 id="overview">Overview&lt;/h2>
&lt;p>My Raspberry Pi 4 Model B (4 GB RAM) has exactly one job: it runs &lt;a href="https://www.home-assistant.io/installation/raspberrypi/" target="_blank" rel="noopener">Home Assistant Operating System&lt;/a> (HAOS).
In this guide, I cover both ways I set it up:&lt;/p>
&lt;ul>
&lt;li>&lt;strong>Clean install:&lt;/strong> flash HAOS onto a microSD card, go through the onboarding, install the apps, set up Zigbee with a Sonoff Zigbee 3.0 USB Dongle Plus and Zigbee2MQTT, and add backups and monitoring (Steps 0 to 7).&lt;/li>
&lt;li>&lt;strong>Restore from backup:&lt;/strong> flash HAOS and restore my latest full backup (Steps 0 to 2, then Step 8).
This is what I usually do, e.g. when an SD card dies or when I move to new hardware, and it just works.&lt;/li>
&lt;/ul>
&lt;p>Step 9 covers a maintenance task: updating the firmware of the Zigbee coordinator.
The script and configuration files I use are in the &lt;a href="https://github.com/wmutschl/scripts/tree/main/Raspberry-Pi-4-Model-B" target="_blank" rel="noopener">Raspberry-Pi-4-Model-B folder of my scripts repository&lt;/a>.&lt;/p>
&lt;div class="alert alert-note">
&lt;div>
I wrote this guide for Home Assistant OS 18.5 and Home Assistant 2026.11.
Home Assistant renamed add-ons to &lt;strong>apps&lt;/strong> in 2026.2, so older guides and forum posts still talk about add-ons.
Since 2026.8, a fresh HAOS installation serves its web interface on port 80 instead of 8123.
&lt;/div>
&lt;/div>
&lt;h2 id="step-0-hardware-and-general-remarks">Step 0: Hardware and general remarks&lt;/h2>
&lt;p>This is my hardware:&lt;/p>
&lt;ul>
&lt;li>&lt;strong>Raspberry Pi 4 Model B with 4 GB RAM.&lt;/strong>
Home Assistant needs at least 2 GB.
Use a proper USB-C power supply such as the official one: Home Assistant warns that phone chargers may not be suitable and that the USB ports of a computer must not be used.&lt;/li>
&lt;li>&lt;strong>Silicon Power 32 GB UHS-I Class 10 microSDHC card.&lt;/strong>
Home Assistant recommends at least 32 GB and an &lt;em>Application Class 2&lt;/em> (A2) card, which handles the many small reads and writes of a running system better.
My card is not A2 rated, so we will see how reliable it is; I have a spare one just in case.
The alternatives are to boot directly from a USB SSD, or to keep booting from the SD card and move the data to a USB SSD with &lt;strong>Settings → System → Storage → Move data disk&lt;/strong>.&lt;/li>
&lt;li>&lt;strong>Sonoff Zigbee 3.0 USB Dongle Plus&lt;/strong> (ZBDongle-P with the Texas Instruments CC2652P chip and a CP210x USB-to-serial bridge) as Zigbee coordinator.
It sits on a 1.5 meter USB extension cable plugged into one of the black USB 2.0 ports.&lt;/li>
&lt;li>&lt;strong>Ethernet cable&lt;/strong> to my FRITZ!Box.
The installation requires Ethernet; Wi-Fi can be configured afterwards, but Ethernet is highly recommended.&lt;/li>
&lt;li>&lt;strong>A computer with an SD card reader&lt;/strong> to flash the card and to do the onboarding in the browser; for me, this is my Mac.&lt;/li>
&lt;/ul>
&lt;div class="alert alert-note">
&lt;div>
&lt;strong>Why the extension cable and the USB 2.0 port?&lt;/strong>
USB 3.0 ports, cables and attached devices like SSDs give off radio noise in the 2.4 GHz band.
That&amp;rsquo;s the same band Zigbee uses, so they can noticeably cut range and reliability.
This is why &lt;a href="https://www.zigbee2mqtt.io/advanced/zigbee/02_improve_network_range_and_stability.html" target="_blank" rel="noopener">Zigbee2MQTT&lt;/a> and Home Assistant both advise against USB 3.
The extension cable also moves the dongle away from the Pi itself.
&lt;/div>
&lt;/div>
&lt;h2 id="step-1-flash-home-assistant-os-onto-the-sd-card">Step 1: Flash Home Assistant OS onto the SD card&lt;/h2>
&lt;h3 id="option-a-raspberry-pi-imager">Option A: Raspberry Pi Imager&lt;/h3>
&lt;p>This is the &lt;a href="https://www.home-assistant.io/installation/raspberrypi/" target="_blank" rel="noopener">official way&lt;/a>:&lt;/p>
&lt;ol>
&lt;li>Install the &lt;a href="https://www.raspberrypi.com/software/" target="_blank" rel="noopener">Raspberry Pi Imager&lt;/a>, on macOS e.g. with &lt;code>brew install --cask raspberry-pi-imager&lt;/code>.&lt;/li>
&lt;li>Insert the SD card and open the Imager.&lt;/li>
&lt;li>Choose &lt;strong>Raspberry Pi 4&lt;/strong> as device, then &lt;strong>Other specific-purpose OS → Home automation → Home Assistant → Home Assistant OS 18.5 (RPi 4/400)&lt;/strong> as operating system, and the SD card as storage.
Don&amp;rsquo;t pick the entries for the Home Assistant Yellow.&lt;/li>
&lt;li>Write the card.
There are no customisation settings for HAOS.
The Imager verifies the card after writing it; afterwards, eject it.&lt;/li>
&lt;/ol>
&lt;h3 id="option-b-terminal-on-macos">Option B: Terminal on macOS&lt;/h3>
&lt;p>If you prefer the terminal, my script &lt;a href="https://github.com/wmutschl/scripts/blob/main/Raspberry-Pi-4-Model-B/flash-haos.sh" target="_blank" rel="noopener">&lt;code>flash-haos.sh&lt;/code>&lt;/a> does the same as the Imager.
It takes the image and its SHA-256 checksums from the metadata that the Imager uses (&lt;a href="https://version.home-assistant.io/rpi-imager-haos.json" target="_blank" rel="noopener">rpi-imager-haos.json&lt;/a>), checks the download and the decompressed image, writes the card with &lt;code>dd&lt;/code> and reads it back to compare.
It refuses internal disks, disks with APFS or HFS+ partitions and disks larger than 2 TiB, and asks you to type the disk identifier before it erases anything.
It needs &lt;code>xz&lt;/code> (&lt;code>brew install xz&lt;/code>) and &lt;code>jq&lt;/code>, which ships with macOS 15 and later.&lt;/p>
&lt;p>Find the identifier of the SD card (e.g. &lt;code>disk5&lt;/code>) by its size:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-sh" data-lang="sh">&lt;span class="line">&lt;span class="cl">diskutil list external physical
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>Then run the script with it:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-sh" data-lang="sh">&lt;span class="line">&lt;span class="cl">git clone https://github.com/wmutschl/scripts.git
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">./scripts/Raspberry-Pi-4-Model-B/flash-haos.sh disk5
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>It keeps the downloaded image in &lt;code>~/Library/Caches/flash-haos&lt;/code>, so flashing a spare card right afterwards doesn&amp;rsquo;t download it again.
If macOS shows a dialog that it cannot read the disk, select &lt;strong>Ignore&lt;/strong>: HAOS uses filesystems that macOS doesn&amp;rsquo;t know.&lt;/p>
&lt;h2 id="step-2-first-boot-and-a-fixed-ip-address">Step 2: First boot and a fixed IP address&lt;/h2>
&lt;ol>
&lt;li>Insert the SD card into the Pi, connect Ethernet, plug the Zigbee dongle (on its extension cable) into one of the black USB 2.0 ports, and finally connect the power supply.&lt;/li>
&lt;li>On your computer, open &lt;a href="http://homeassistant.local" target="_blank" rel="noopener">http://homeassistant.local&lt;/a>.
If that doesn&amp;rsquo;t load, try &lt;code>http://homeassistant.local:8123&lt;/code> or the IP address of the Pi, which you find in the router.
The page should come up within a few minutes; then Home Assistant may show &lt;strong>Preparing Home Assistant&lt;/strong> while it downloads the latest version, which can take 20 minutes or more.&lt;/li>
&lt;li>In the meantime, give the Pi a fixed IP address in the router.
In the FRITZ!Box, open the device (it shows up as &lt;code>homeassistant&lt;/code>) under &lt;strong>Home Network → Network → Network Connections&lt;/strong>, edit it and turn on the permanent IPv4 address (&lt;strong>Always assign this network device the same IPv4 address&lt;/strong>; newer FRITZ!OS versions call it &lt;strong>Assign permanent IPv4 address&lt;/strong>).&lt;/li>
&lt;/ol>
&lt;p>The reservation is tied to the MAC address of the Pi&amp;rsquo;s Ethernet port, so it survives reflashing the card and restoring backups.
In Home Assistant, I leave the network settings (&lt;strong>Settings → System → Network&lt;/strong>) on automatic, with Wi-Fi disabled.&lt;/p>
&lt;h2 id="step-3-onboarding">Step 3: Onboarding&lt;/h2>
&lt;p>For a clean install, select &lt;strong>Create my smart home&lt;/strong> on the welcome screen.
If you want to restore a backup instead, go to &lt;a href="#step-8-restore-from-a-backup">Step 8&lt;/a>.&lt;/p>
&lt;ol>
&lt;li>Create the owner account with &lt;strong>Name&lt;/strong>, &lt;strong>Username&lt;/strong> (lowercase, no spaces) and &lt;strong>Password&lt;/strong>.
Store it in your password manager: there is no way to recover the owner credentials.&lt;/li>
&lt;li>Set your home location by searching the address or with &lt;strong>Detect&lt;/strong>, and the country and time zone if asked.&lt;/li>
&lt;li>Choose what to share on the &lt;strong>Help us help you&lt;/strong> screen; everything is off by default.&lt;/li>
&lt;li>Home Assistant lists the devices and services it found on the network.
Select &lt;strong>Finish&lt;/strong>.&lt;/li>
&lt;/ol>
&lt;p>Afterwards, I install pending updates under &lt;strong>Settings → System → Updates&lt;/strong> and turn on multi-factor authentication in my user profile under &lt;strong>Security&lt;/strong>.&lt;/p>
&lt;h2 id="step-4-apps">Step 4: Apps&lt;/h2>
&lt;p>I install these apps from &lt;strong>Settings → Apps → Install app&lt;/strong>:&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>App&lt;/th>
&lt;th>Repository&lt;/th>
&lt;th>What I use it for&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Mosquitto broker&lt;/td>
&lt;td>Official&lt;/td>
&lt;td>MQTT broker for Zigbee2MQTT&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Zigbee2MQTT&lt;/td>
&lt;td>&lt;a href="https://github.com/zigbee2mqtt/hassio-zigbee2mqtt" target="_blank" rel="noopener">zigbee2mqtt/hassio-zigbee2mqtt&lt;/a>, see &lt;a href="#step-5-zigbee2mqtt-with-the-sonoff-dongle">Step 5&lt;/a>&lt;/td>
&lt;td>Zigbee network with the Sonoff dongle&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Matter Server&lt;/td>
&lt;td>Official&lt;/td>
&lt;td>Matter devices&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Tailscale&lt;/td>
&lt;td>Home Assistant Community Apps&lt;/td>
&lt;td>Remote access over my tailnet, without opening any ports&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Advanced SSH &amp;amp; Web Terminal&lt;/td>
&lt;td>Home Assistant Community Apps&lt;/td>
&lt;td>A shell with the &lt;code>ha&lt;/code> command line interface&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Studio Code Server&lt;/td>
&lt;td>Home Assistant Community Apps&lt;/td>
&lt;td>Editing the YAML files in the browser&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>For each app: select it, &lt;strong>Install&lt;/strong>, adjust the &lt;strong>Configuration&lt;/strong> tab if needed, and &lt;strong>Start&lt;/strong>.
On the &lt;strong>Info&lt;/strong> tab, I turn on &lt;strong>Start on boot&lt;/strong> and &lt;strong>Watchdog&lt;/strong>, and &lt;strong>Show in sidebar&lt;/strong> for apps with a web interface.
Some notes:&lt;/p>
&lt;ul>
&lt;li>&lt;strong>Mosquitto broker:&lt;/strong> After it has started, Home Assistant discovers the &lt;strong>MQTT&lt;/strong> integration under &lt;strong>Settings → Devices &amp;amp; services&lt;/strong>; add it.
Zigbee2MQTT finds the broker on its own.&lt;/li>
&lt;li>&lt;strong>Matter Server:&lt;/strong> Add the discovered &lt;strong>Matter&lt;/strong> integration afterwards.
New Matter devices are commissioned with the Home Assistant Companion app on the phone.&lt;/li>
&lt;li>&lt;strong>Tailscale:&lt;/strong> Open the web interface of the app and log in to your tailnet.
From then on, the Companion app reaches Home Assistant over the tailnet from anywhere.
The &lt;a href="https://github.com/hassio-addons/app-tailscale" target="_blank" rel="noopener">app documentation&lt;/a> covers options like sharing Home Assistant over HTTPS within the tailnet.&lt;/li>
&lt;li>&lt;strong>Advanced SSH &amp;amp; Web Terminal:&lt;/strong> If you want SSH access in addition to the web terminal, set a username and add your public key to &lt;code>authorized_keys&lt;/code> in the &lt;strong>Configuration&lt;/strong> tab.
In the terminal, the configuration folder of Home Assistant is &lt;code>/homeassistant&lt;/code>.&lt;/li>
&lt;/ul>
&lt;h2 id="step-5-zigbee2mqtt-with-the-sonoff-dongle">Step 5: Zigbee2MQTT with the Sonoff dongle&lt;/h2>
&lt;ol>
&lt;li>Under &lt;strong>Settings → Apps → Install app → ⋮ → Repositories&lt;/strong>, add &lt;code>https://github.com/zigbee2mqtt/hassio-zigbee2mqtt&lt;/code>, then select &lt;strong>Add&lt;/strong> and &lt;strong>Close&lt;/strong>.&lt;/li>
&lt;li>Install &lt;strong>Zigbee2MQTT&lt;/strong>, not &lt;em>Zigbee2MQTT Edge&lt;/em>, which follows the development branch.
Start it and turn on &lt;strong>Start on boot&lt;/strong>, &lt;strong>Watchdog&lt;/strong> and &lt;strong>Show in sidebar&lt;/strong>.&lt;/li>
&lt;li>Open its web interface.
On the first start, Zigbee2MQTT shows an onboarding page.
Under &lt;strong>Found Devices&lt;/strong>, select the dongle; this sets the serial port and the adapter type (&lt;code>zstack&lt;/code> for the ZBDongle-P).
For my dongle, the port is &lt;code>/dev/serial/by-id/usb-Silicon_Labs_Sonoff_Zigbee_3.0_USB_Dongle_Plus_0001-if00-port0&lt;/code>.
Choose a Zigbee channel away from your 2.4 GHz Wi-Fi; the onboarding asks for your Wi-Fi channel to help with that.
&lt;strong>Submit&lt;/strong> and wait: a &lt;code>502: Bad Gateway&lt;/code> only means Zigbee2MQTT is still starting.&lt;/li>
&lt;li>Pair devices with &lt;strong>Permit join (All)&lt;/strong> in the Zigbee2MQTT interface.
They show up in Home Assistant through the MQTT integration.&lt;/li>
&lt;/ol>
&lt;p>Only one piece of software may use the dongle, so if Home Assistant discovers it for its own Zigbee integration (ZHA) under &lt;strong>Settings → Devices &amp;amp; services&lt;/strong>, ignore that discovery.&lt;/p>
&lt;p>Zigbee2MQTT keeps its configuration, its device database and the file &lt;code>coordinator_backup.json&lt;/code> with the network settings (network key, PAN ID, channel) in &lt;code>/homeassistant/zigbee2mqtt&lt;/code>.
That&amp;rsquo;s part of the configuration folder of Home Assistant, so every Home Assistant backup contains the complete Zigbee network.&lt;/p>
&lt;h2 id="step-6-encrypted-backups-to-an-smb-share">Step 6: Encrypted backups to an SMB share&lt;/h2>
&lt;p>Keep native full Home Assistant backups off the Pi.
Mine go to an SMB share on my home server, a Dell Wyse 5070 thin client with Ubuntu.
The server snapshots them hourly with Btrfs, sends them to an encrypted HDD every night, and mirrors them off-site to a Hetzner Storage Box.
Home Assistant encrypts its backups with its own key, so neither the share nor the off-site copy ever holds readable data.
On the server side, it&amp;rsquo;s a single SMB 3 share &lt;code>ha-backups&lt;/code> for a single account &lt;code>hass-backup&lt;/code>, which accepts only the Pi; see the &lt;a href="https://github.com/wmutschl/scripts/blob/main/Dell-Wyse-Thin-Client-5070/etc/samba/smb.conf" target="_blank" rel="noopener">smb.conf&lt;/a> in my scripts repository.
Any NAS with SMB or NFS works the same way.&lt;/p>
&lt;p>In Home Assistant:&lt;/p>
&lt;ol>
&lt;li>
&lt;p>&lt;strong>Settings → System → Storage → Add storage&lt;/strong>: Name &lt;code>dell_wyse&lt;/code> (only letters, digits and underscores are allowed), usage &lt;strong>Backup&lt;/strong>, type &lt;strong>Samba/Windows (CIFS)&lt;/strong>, the IP address of the server, remote share &lt;code>ha-backups&lt;/code>, and username and password of the share.
Select &lt;strong>Connect&lt;/strong>.
If it asks for a CIFS version, keep &lt;strong>Auto (2.1+)&lt;/strong>.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>&lt;strong>Settings → System → Backups → Set up backups&lt;/strong> (later: &lt;strong>Configure backup settings&lt;/strong> on the &lt;strong>Automatic backup&lt;/strong> card), then &lt;strong>Custom&lt;/strong>.
My settings:&lt;/p>
&lt;ul>
&lt;li>&lt;strong>Schedule:&lt;/strong> daily at &lt;strong>System optimal&lt;/strong> time, which is between 04:45 and 05:45.
As preference when updating: &lt;strong>Backup before update&lt;/strong>.&lt;/li>
&lt;li>&lt;strong>Retention:&lt;/strong> 7 backups.&lt;/li>
&lt;li>&lt;strong>Backup data:&lt;/strong> the Home Assistant settings (always included), the history and all apps.
Media and the share folder stay off; turn them on if you keep camera recordings or app data there.&lt;/li>
&lt;li>&lt;strong>Locations:&lt;/strong> &lt;strong>This system&lt;/strong>, for quick restores on the Pi, and &lt;code>dell_wyse&lt;/code>.&lt;/li>
&lt;/ul>
&lt;p>The cog next to a location opens its own retention and encryption settings.
On &lt;strong>This system&lt;/strong>, I keep 60 backups; at about 40 MB each, they are cheap, but they die with the SD card.
&lt;code>dell_wyse&lt;/code> uses the global 7, since the server&amp;rsquo;s snapshots keep older ones for months anyway.
Both locations should say &lt;em>Backups made to this location will be encrypted&lt;/em>.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>On the &lt;strong>Encryption key&lt;/strong> card, select &lt;strong>Download emergency kit&lt;/strong> and store the file in your password manager.
Without this key, the backups are useless.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Create the first backup right away with &lt;strong>Backup now → Manual backup&lt;/strong>, with &lt;strong>Apps&lt;/strong> set to &lt;strong>All&lt;/strong>, and check that it arrives on the server:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-sh" data-lang="sh">&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># on the server&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">sudo ls -lh /srv/ha-backups
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;/li>
&lt;/ol>
&lt;p>When an upload fails, Home Assistant shows a repair (&lt;em>Automatic backup could not be uploaded to the configured locations&lt;/em>) under &lt;strong>Settings → System → Repairs&lt;/strong>.
My server additionally checks every morning that a backup newer than 26 hours has arrived, and otherwise alerts me through healthchecks.io (&lt;a href="https://github.com/wmutschl/scripts/blob/main/Dell-Wyse-Thin-Client-5070/usr/local/sbin/dell-wyse-ha-backup-check" target="_blank" rel="noopener">dell-wyse-ha-backup-check&lt;/a>).
That also catches a dead Pi, which nothing on the Pi could report.&lt;/p>
&lt;h2 id="step-7-healthchecksio-heartbeat">Step 7: healthchecks.io heartbeat&lt;/h2>
&lt;p>I want to know when Home Assistant itself is down.
So Home Assistant pings a check on &lt;a href="https://healthchecks.io" target="_blank" rel="noopener">healthchecks.io&lt;/a> every minute, and healthchecks.io alerts me when the pings stop.
I keep the REST command and the automation together in a &lt;a href="https://www.home-assistant.io/docs/configuration/packages/" target="_blank" rel="noopener">package&lt;/a>, which is a single file that I can keep in my scripts repository.
The files below are in the configuration folder of Home Assistant, which is &lt;code>/homeassistant&lt;/code> in the web terminal; I edit them with Studio Code Server.&lt;/p>
&lt;ol>
&lt;li>Create a check on healthchecks.io, e.g. with a period of 1 minute and a grace time of 5 minutes, and copy its ping URL.&lt;/li>
&lt;li>Add the ping URL to &lt;code>secrets.yaml&lt;/code>, so it stays out of the configuration files:
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-yaml" data-lang="yaml">&lt;span class="line">&lt;span class="cl">&lt;span class="nt">healthchecks_ping_url&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w"> &lt;/span>&lt;span class="s2">&amp;#34;https://hc-ping.com/&amp;lt;uuid-of-the-check&amp;gt;&amp;#34;&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;/li>
&lt;li>Enable packages in &lt;code>configuration.yaml&lt;/code>; if there is a &lt;code>homeassistant:&lt;/code> section already, add the &lt;code>packages:&lt;/code> line to it:
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-yaml" data-lang="yaml">&lt;span class="line">&lt;span class="cl">&lt;span class="nt">homeassistant&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="w"> &lt;/span>&lt;span class="nt">packages&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w"> &lt;/span>!&lt;span class="l">include_dir_named packages&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>Studio Code Server underlines &lt;code>packages&lt;/code> with a &lt;em>patternWarning&lt;/em>.
That&amp;rsquo;s a false positive of its Home Assistant extension; the line is exactly what the &lt;a href="https://www.home-assistant.io/docs/configuration/packages/" target="_blank" rel="noopener">documentation&lt;/a> says.&lt;/li>
&lt;li>Create the file &lt;code>packages/healthchecks.yaml&lt;/code> (with &lt;code>.yaml&lt;/code>, because &lt;code>!include_dir_named&lt;/code> silently skips &lt;code>.yml&lt;/code> files) with the content of my &lt;a href="https://github.com/wmutschl/scripts/blob/main/Raspberry-Pi-4-Model-B/homeassistant/packages/healthchecks.yaml" target="_blank" rel="noopener">healthchecks.yaml&lt;/a>:
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-yaml" data-lang="yaml">&lt;span class="line">&lt;span class="cl">&lt;span class="nt">rest_command&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="w"> &lt;/span>&lt;span class="nt">healthchecks_ping&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="w"> &lt;/span>&lt;span class="nt">url&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w"> &lt;/span>!&lt;span class="l">secret healthchecks_ping_url&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="w"> &lt;/span>&lt;span class="nt">method&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w"> &lt;/span>&lt;span class="l">get&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="w">&lt;/span>&lt;span class="nt">automation&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="w"> &lt;/span>- &lt;span class="nt">id&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w"> &lt;/span>&lt;span class="l">healthchecks_ping&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="w"> &lt;/span>&lt;span class="nt">alias&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w"> &lt;/span>&lt;span class="l">Healthchecks Ping&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="w"> &lt;/span>&lt;span class="nt">description&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w"> &lt;/span>&lt;span class="l">Ping healthchecks.io every minute&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="w"> &lt;/span>&lt;span class="nt">triggers&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="w"> &lt;/span>- &lt;span class="nt">trigger&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w"> &lt;/span>&lt;span class="l">time_pattern&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="w"> &lt;/span>&lt;span class="nt">minutes&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w"> &lt;/span>&lt;span class="s2">&amp;#34;*&amp;#34;&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="w"> &lt;/span>&lt;span class="nt">conditions&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w"> &lt;/span>&lt;span class="p">[]&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="w"> &lt;/span>&lt;span class="nt">actions&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="w"> &lt;/span>- &lt;span class="nt">action&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w"> &lt;/span>&lt;span class="l">rest_command.healthchecks_ping&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="w"> &lt;/span>&lt;span class="nt">mode&lt;/span>&lt;span class="p">:&lt;/span>&lt;span class="w"> &lt;/span>&lt;span class="l">single&lt;/span>&lt;span class="w">
&lt;/span>&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;/li>
&lt;li>Check the configuration with &lt;code>ha core check&lt;/code> in the web terminal; it reports either success or the errors.
Then restart Home Assistant with &lt;strong>Settings → ⋮ → Restart Home Assistant&lt;/strong>.
Afterwards, healthchecks.io should get a ping every minute, and the traces of the automation &lt;em>Healthchecks Ping&lt;/em> show every run.&lt;/li>
&lt;/ol>
&lt;div class="alert alert-note">
&lt;div>
If you prefer the automation editor, put the &lt;strong>rest_command&lt;/strong> section into &lt;strong>configuration.yaml&lt;/strong> instead, create a new automation, switch to &lt;strong>Edit in YAML&lt;/strong> and paste the automation from above without its &lt;strong>id&lt;/strong> line.
&lt;/div>
&lt;/div>
&lt;h2 id="step-8-restore-from-a-backup">Step 8: Restore from a backup&lt;/h2>
&lt;p>This is the path for a dead SD card, a move to other hardware, or a fresh start with the old configuration.&lt;/p>
&lt;h3 id="what-you-need">What you need&lt;/h3>
&lt;ul>
&lt;li>&lt;strong>A full backup&lt;/strong>, i.e. the &lt;code>.tar&lt;/code> file.
Mine are on the share of my home server, from where I copy the newest one to my Mac.
The directory belongs to the Samba account, so the copy takes a detour through my home directory on the server:
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-sh" data-lang="sh">&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># list the newest backups (dell-wyse is my home server)&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">ssh -t dell-wyse &lt;span class="s1">&amp;#39;sudo ls -t /srv/ha-backups | head -n 3&amp;#39;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># automatic_backup_2026_11_2_2026-11-17_15.12_27439464.tar&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># automatic_backup_2026_11_1_2026-11-17_12.49_48712075.tar&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># automatic_backup_2026_11_1_2026-11-17_05.42_26004763.tar&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># copy the newest one to the Mac; use the name from your list&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">ssh -t dell-wyse &lt;span class="s1">&amp;#39;sudo install -m 0600 -o &amp;#34;$(id -u)&amp;#34; -g &amp;#34;$(id -g)&amp;#34; /srv/ha-backups/automatic_backup_2026_11_2_2026-11-17_15.12_27439464.tar ~/&amp;#39;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">scp dell-wyse:automatic_backup_2026_11_2_2026-11-17_15.12_27439464.tar ~/Downloads/
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">ssh dell-wyse &lt;span class="s1">&amp;#39;rm ~/automatic_backup_2026_11_2_2026-11-17_15.12_27439464.tar&amp;#39;&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>If the old system still runs, you can also download a backup in its web interface under &lt;strong>Settings → System → Backups → Show all backups&lt;/strong>.&lt;/li>
&lt;li>&lt;strong>The encryption key&lt;/strong> from the emergency kit.
A backup downloaded through the web interface is decrypted on the fly by default and needs no key.&lt;/li>
&lt;li>&lt;strong>Enough space:&lt;/strong> the new card needs more free space than the old system used, plus 2 GB.
In the terminal, &lt;code>ha host info&lt;/code> shows the usage as &lt;code>disk_used&lt;/code>; mine uses 9.1 GB of the 28.6 GB that HAOS gets on the 32 GB card.&lt;/li>
&lt;li>&lt;strong>Only one Home Assistant at a time:&lt;/strong> if the old system still runs, shut it down first.
Otherwise both would control the same Matter devices and cloud integrations, and claim the same machine in the tailnet.&lt;/li>
&lt;/ul>
&lt;h3 id="restore-during-the-onboarding">Restore during the onboarding&lt;/h3>
&lt;ol>
&lt;li>Flash and boot as in &lt;a href="#step-1-flash-home-assistant-os-onto-the-sd-card">Step 1&lt;/a> and &lt;a href="#step-2-first-boot-and-a-fixed-ip-address">Step 2&lt;/a>, with the Zigbee dongle in the same USB 2.0 port as before.
On the same Pi, the FRITZ!Box hands out the same IP address.
On a different Pi, move the reservation to the new device.&lt;/li>
&lt;li>On the welcome screen, select &lt;strong>Upload backup&lt;/strong> below &lt;strong>Or restore&lt;/strong>, then &lt;strong>Select backup file&lt;/strong> and choose the &lt;code>.tar&lt;/code> file.&lt;/li>
&lt;li>Select all parts of the backup, enter the encryption key from the emergency kit and select &lt;strong>Restore backup&lt;/strong>.&lt;/li>
&lt;li>Wait while Home Assistant restores the backup and downloads all apps again; on my Pi 4, this takes about 10 minutes.
The page may lose its connection in between.
The restored system uses the web server port of the old one, so if &lt;code>http://homeassistant.local&lt;/code> stops responding after the restore, try &lt;code>http://homeassistant.local:8123&lt;/code>, the default of installations from before Home Assistant 2026.8.
Mine came back on 8123, and I then switched it to 80 under &lt;strong>Settings → System → Network → HTTP server&lt;/strong>.
Confirm the new port within 5 minutes, otherwise Home Assistant reverts to the old one.
Afterwards, update the server address in the Companion app and, if you share Home Assistant with the Tailscale app, restart that app.&lt;/li>
&lt;li>Log in with your old account.&lt;/li>
&lt;/ol>
&lt;div class="alert alert-note">
&lt;div>
&lt;strong>Alternative without copying the backup:&lt;/strong> On the welcome screen, select &lt;strong>Create my smart home&lt;/strong> with a throwaway account, add the network storage exactly as in &lt;a href="#step-6-encrypted-backups-to-an-smb-share">Step 6&lt;/a>, with the same name, and open &lt;strong>Settings → System → Backups → Show all backups&lt;/strong>.
Select the newest backup on that location, select everything under &lt;strong>Select what to restore&lt;/strong>, enter the encryption key and select &lt;strong>Restore&lt;/strong>.
The restore replaces the throwaway account and all settings, including the network storage.
&lt;/div>
&lt;/div>
&lt;h3 id="checks-after-the-restore">Checks after the restore&lt;/h3>
&lt;ul>
&lt;li>&lt;strong>Settings → Apps:&lt;/strong> all apps are back and running.
In the logs of Mosquitto and Zigbee2MQTT, the broker accepts connections and the coordinator has started.
Zigbee2MQTT may first log &lt;code>ENOTFOUND core-mosquitto&lt;/code> while Mosquitto is still starting, which is fine if it connects afterwards.&lt;/li>
&lt;li>Switch a mains-powered Zigbee device.
Battery-powered devices report in when they wake up.&lt;/li>
&lt;li>Matter devices respond, and Tailscale shows the Pi as online: its state is part of the backup, so it rejoins the tailnet as the same machine.&lt;/li>
&lt;li>&lt;strong>Settings → System → Storage:&lt;/strong> the network storage is connected again; the backup includes it.&lt;/li>
&lt;li>&lt;strong>Settings → System → Backups:&lt;/strong> the automatic backups are set up as before.
The encryption key comes back with the restored settings, so the emergency kit in your password manager stays valid; for me, the key was the same.
Under &lt;strong>Configure backup settings&lt;/strong>, the cog next to each location should say &lt;em>Backups made to this location will be encrypted&lt;/em>.
If it shows a &lt;strong>Turn on&lt;/strong> button instead, turn it on, in particular for &lt;strong>This system&lt;/strong>.&lt;/li>
&lt;li>The uploaded backup stays on &lt;strong>This system&lt;/strong> as a manual backup, and the retention never deletes manual backups.
If you downloaded it through the web interface, it is not encrypted either.
Delete it under &lt;strong>Settings → System → Backups → Show all backups&lt;/strong> once the restored system has made its own backups.
To see which backups are encrypted where, run this in the terminal:
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-sh" data-lang="sh">&lt;span class="line">&lt;span class="cl">ha backups --raw-json &lt;span class="p">|&lt;/span> jq -r &lt;span class="s1">&amp;#39;.data.backups | sort_by(.date)[] | &amp;#34;\(.date[:16]) \(.name): &amp;#34; + ([.location_attributes | to_entries[] | &amp;#34;\(.key) \(if .value.protected then &amp;#34;encrypted&amp;#34; else &amp;#34;NOT encrypted&amp;#34; end)&amp;#34;] | join(&amp;#34;, &amp;#34;))&amp;#39;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 2026-11-14T14:38 Migration_To_Pi: .local NOT encrypted&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 2026-11-15T04:24 Automatic backup 2026.11.1: .local encrypted&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># ...&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 2026-11-17T04:42 Automatic backup 2026.11.1: .local encrypted, dell_wyse encrypted&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;/li>
&lt;li>healthchecks.io receives pings again.&lt;/li>
&lt;li>Finally, create a manual backup and check that it lands on the share.&lt;/li>
&lt;/ul>
&lt;h2 id="step-9-update-the-firmware-of-the-zigbee-dongle">Step 9: Update the firmware of the Zigbee dongle&lt;/h2>
&lt;p>Check the current coordinator firmware of the dongle (&lt;code>zStack3x0&lt;/code>) in the Zigbee2MQTT interface under &lt;strong>Settings → About&lt;/strong>: the coordinator version shows the revision, e.g. &lt;code>20240710&lt;/code>.
Compare this with the latest version in the &lt;a href="https://github.com/Koenkk/Z-Stack-firmware/blob/master/coordinator/Z-Stack_3.x.0/CHANGELOG.md" target="_blank" rel="noopener">changelog of Koenkk/Z-Stack-firmware&lt;/a>; as of November 2026, the latest coordinator firmware for the CC2652P is 20250321.&lt;/p>
&lt;h3 id="backup-first">Backup first&lt;/h3>
&lt;ol>
&lt;li>In Zigbee2MQTT, go to &lt;strong>Settings → Tools&lt;/strong> and select &lt;strong>Request Z2m backup&lt;/strong>.
Wait a couple of seconds, then select &lt;strong>Download Zigbee2MQTT backup&lt;/strong> and save the zip file on your computer.&lt;/li>
&lt;li>In Home Assistant, create a backup with &lt;strong>Settings → System → Backups → Backup now → Manual backup&lt;/strong>.
Make sure that &lt;strong>Apps&lt;/strong> is set to &lt;strong>All&lt;/strong>, select &lt;strong>Next&lt;/strong>, give it a name and select &lt;strong>Create backup&lt;/strong>.
When it has finished, download it under &lt;strong>⋮ → Download&lt;/strong>.&lt;/li>
&lt;li>In the web terminal, check that &lt;code>coordinator_backup.json&lt;/code> exists and is recent:
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-sh" data-lang="sh">&lt;span class="line">&lt;span class="cl">stat -c &lt;span class="s1">&amp;#39;%y&amp;#39;&lt;/span> /homeassistant/zigbee2mqtt/coordinator_backup.json
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="c1"># 2026-11-15 12:14:33.621662213 +0100&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;/li>
&lt;/ol>
&lt;h3 id="stop-zigbee2mqtt">Stop Zigbee2MQTT&lt;/h3>
&lt;ol>
&lt;li>In Home Assistant, go to &lt;strong>Settings → Apps → Zigbee2MQTT&lt;/strong> and select &lt;strong>Stop&lt;/strong>.&lt;/li>
&lt;li>Temporarily turn off &lt;strong>Watchdog&lt;/strong> and &lt;strong>Start on boot&lt;/strong> for the app, so Home Assistant doesn&amp;rsquo;t try to start it while the dongle is gone.&lt;/li>
&lt;li>If ZHA is set up, make sure it is disabled.
Only one thing may use the dongle.&lt;/li>
&lt;/ol>
&lt;h3 id="flash-the-firmware-with-the-sonoff-dongle-flasher">Flash the firmware with the SONOFF Dongle Flasher&lt;/h3>
&lt;p>This needs a computer with Chrome or Edge, because the flasher uses Web Serial; Firefox and Safari don&amp;rsquo;t support it.
The alternative is &lt;a href="https://github.com/JelmerT/cc2538-bsl" target="_blank" rel="noopener">cc2538-bsl&lt;/a>, which is more reliable but also more involved.&lt;/p>
&lt;ol>
&lt;li>Unplug the dongle from the Raspberry Pi and plug it into your computer.&lt;/li>
&lt;li>Open the &lt;a href="https://dongle.sonoff.tech/sonoff-dongle-flasher/" target="_blank" rel="noopener">SONOFF Dongle Flasher&lt;/a> in Chrome or Edge and select &lt;strong>Connect&lt;/strong>.
On Windows, install the Silicon Labs CP210x USB-to-UART driver if no COM port shows up.&lt;/li>
&lt;li>Select the port of the &lt;strong>Sonoff Zigbee 3.0 USB Dongle Plus&lt;/strong> (on macOS, &lt;code>cu.usbserial-…&lt;/code>), then &lt;strong>Connect&lt;/strong> and &lt;strong>Allow&lt;/strong>.&lt;/li>
&lt;li>Check what the flasher shows:
&lt;ul>
&lt;li>&lt;code>Current Device: ZBDongle-P&lt;/code> means that it detected the dongle correctly.&lt;/li>
&lt;li>&lt;code>Current FW: Zigbee NCP 20240710&lt;/code> matches the firmware Zigbee2MQTT reported, so the flasher reads the dongle properly.&lt;/li>
&lt;li>&lt;code>Upgrade To: Zigbee NCP 20250321, Stable&lt;/code> is the newest coordinator firmware.
&lt;em>Zigbee NCP&lt;/em> is SONOFF&amp;rsquo;s name for the coordinator firmware.
Don&amp;rsquo;t pick the &lt;em>Router&lt;/em> firmware under &lt;em>Change firmware&lt;/em>.&lt;/li>
&lt;li>&lt;code>Baudrate 115200&lt;/code> is the standard rate and works with Zigbee2MQTT.&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>Start &lt;strong>Flash&lt;/strong> and wait until it reports success.
Don&amp;rsquo;t unplug the dongle while it runs.&lt;/li>
&lt;li>Unplug the dongle from your computer.&lt;/li>
&lt;/ol>
&lt;h3 id="put-it-back-and-start-zigbee2mqtt">Put it back and start Zigbee2MQTT&lt;/h3>
&lt;ol>
&lt;li>Plug the dongle back into the same black USB 2.0 port of the Pi, on its extension cable.&lt;/li>
&lt;li>In Home Assistant, go to &lt;strong>Settings → Apps → Zigbee2MQTT&lt;/strong> and select &lt;strong>Start&lt;/strong>.&lt;/li>
&lt;li>Turn &lt;strong>Watchdog&lt;/strong> and &lt;strong>Start on boot&lt;/strong> back on.&lt;/li>
&lt;/ol>
&lt;h3 id="check-that-it-worked">Check that it worked&lt;/h3>
&lt;ul>
&lt;li>The log shows that Zigbee2MQTT restored the coordinator from its backup (on the first start after flashing, which erased the network settings on the dongle) and a line like &lt;code>Coordinator firmware version: '{&amp;quot;meta&amp;quot;:{…&amp;quot;revision&amp;quot;:20250321…},&amp;quot;type&amp;quot;:&amp;quot;zStack3x0&amp;quot;}'&lt;/code>.&lt;/li>
&lt;li>The Zigbee2MQTT interface shows &lt;strong>20250321&lt;/strong> under &lt;strong>Settings → About&lt;/strong>.&lt;/li>
&lt;li>Toggle a few mains-powered devices like lights and plugs.
Battery devices may take a while to report in again; that&amp;rsquo;s normal.&lt;/li>
&lt;/ul></description></item></channel></rss>