Collect diagnostics before resetting the controller.
On this page
Record what happened
- The indoor-unit model, controller board and installed firmware version.
- The app or browser you used, the action you tried and what happened instead.
- Any light pattern or error message, and completed troubleshooting checks.
Copy diagnostics for support
On HomeKit-compatible or Matter-compatible firmware:
- Open the web interface and expand About.
- Select Copy Diagnostics.
- Paste the text into your message or the contact form.
The summary includes firmware, network and device addresses, connection state, error codes and recent events. It omits your Wi-Fi password and setup code.
Capture a live log
On HomeKit-compatible or Matter-compatible firmware, capture a log while reproducing the problem:
- Open the web interface and expand Diagnostics · Logs.
- Under Log Level, select Debug for the most detail.
- Leave the page open and make the problem happen again.
- Select Copy under Live Log and paste the text into your message.
Capture ESPHome logs
- Open the ESPHome dashboard and select Logs on the controller's card.
- Repeat the action that causes the problem.
- Copy the relevant messages and include the firmware version and configuration options you use.
The controller's web page also provides logs when its web server is enabled. Optional diagnostic sensors can be added through the YAML generator.
Send a support request
Send the information through the contact form. Remove passwords and other secrets from logs or custom YAML before sharing.
Back up or restore settings
See Back up and restore settings before a firmware change or reset.
Understand a device event
Look up device events, restart reasons and counters in the diagnostics reference.