Home Assistant Add-On Development

Expert guidance for building, configuring, and publishing Home Assistant add-ons with Docker, Supervisor integration, and multi-architecture support.

Before You Start

This skill prevents common Home Assistant add-on development errors:

Issue	Symptom	Solution
Permission errors	`Permission denied` on supervisor API calls	Use correct SUPERVISOR_TOKEN and API endpoints
Configuration validation	Add-on won't load	Validate config.yaml schema before publishing
Docker base image errors	Missing dependencies in runtime	Use official Home Assistant base images (ghcr.io/home-assistant)
Ingress misconfiguration	Web UI not accessible through HA	Configure nginx reverse proxy correctly
Multi-arch build failures	Add-on only works on one architecture	Set up build.yaml with architecture matrix