Developing Integration for Koolnova Control Unit - 404 Error on Dev enviroment Local Setup

Hello everyone,

I’m working on developing an integration for my Koolnova control unit. So far, I’ve successfully reverse-engineered their API and can:

  • Fetch data for each Control Zone
  • Set the setpoint temperature
  • Change the mode (cool, heat, etc.)

Setup

I’m using Windows 11 with WSL and followed Setting up a Home Assistant development environment on Windows.md · GitHub for setting up the development environment.

Issue

The setup seems to work fine initially:

  • No errors appear in the VS Code console
  • Home Assistant Core and Frontend appear to be running

However, when I try to access the web interface, I encounter a 404 error:

*localhost:8123/onboarding.html
*localhost:8123

Both return “Error 404: File not found”

I’ve also tried using curl http://localhost:8123 from within WSL, which returns the same “file not found” error. This leads me to believe it’s not a network issue.

Question

Does anyone have any ideas on what might be causing this issue or how I can troubleshoot it further? This are the only errors i see.

Thank you in advance for any help or suggestions!

Replaying to this one for myself. After carefully reading the documentation everything worked perfectly.

Dear idan1109 would you be so kind as to share any tips or link to GitHub pointing to your Koolnova integration. It’d be great to contribute and try your work.