Why do I see a 401 Unauthorized error or a blank Zircon3D dashboard in Home Assistant?

[Tami Liu]

This usually happens due to a Home Assistant ingress authorization issue.

Related: https://forum.zircon3d.com/topic/6/

How to fix it

You have two options:

Option 1 (Recommended)
Use port :11200 to access Zircon3D directly.

• Open Zircon3D via http://<your-ha-ip>:11200
• Copy and use the view link from there
• This avoids the ingress issue entirely

Option 2 (Using default HA port 8123)
If you’re accessing through port 8123, you need to authorize Zircon3D first:

• Open Home Assistant
• Click the Zircon3D tab in the left sidebar
• Then reload your dashboard/view

Why this happens

Home Assistant only initializes ingress access after the add-on UI is opened once. If you try to load an embedded Zircon3D view before that, it may return a 401 Unauthorized error.

---

If the issue persists, feel free to reach out with details about your setup