Collect diagnostics for support

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:

  1. Open the web interface and expand About.
  2. Select Copy Diagnostics.
  3. Paste the text into your message or the contact form.
About section listing board, firmware version, IP address, mDNS name, MAC, last reset, boots, crashes, memory and drop counts, a Copy Diagnostics button, and a Device Events list
Wi-Fi Drops and Pump Link Drops count since the last restart. Boots and Crashes count since the last factory reset. View full-size screenshot.

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:

  1. Open the web interface and expand Diagnostics · Logs.
  2. Under Log Level, select Debug for the most detail.
  3. Leave the page open and make the problem happen again.
  4. Select Copy under Live Log and paste the text into your message.
Diagnostics · Logs section with Log Level set to Debug, Copy and Clear buttons, and several live log lines
The log keeps the last 200 lines, and only while the page is open. Debug returns to Info when the controller restarts. View full-size screenshot.

Capture ESPHome logs

  1. Open the ESPHome dashboard and select Logs on the controller's card.
  2. Repeat the action that causes the problem.
  3. 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.

Last updated

Browse the manual ↑