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.