How home-assistant/supervisor works
Home Assistant Supervisor is the control plane for a container-based Home Assistant installation. Home Assistant or an administrator uses its API to manage applications and installation settings; the Supervisor coordinates those operations across Docker, host services, backups, and system integrations. The graph preserves the README’s central API-to-management workflow and the major product subsystems visible in the tree. Some relationships are documented rather than demonstrated in excerpts, so those edges cite the README or are marked unverified; unsampled modules are represented only at supported directory paths.
Main entry points: coresys.py Core orchestration · api Supervisor API · host/manager.py Host management · apps/manager.py Application manager
Components 22
Control plane
- Supervisor API
supervisor/api - Core orchestration
supervisor/coresys.py - Job coordination
supervisor/jobs/decorator.py - Authentication
supervisor/auth.py - Issue resolution
supervisor/resolution
Applications
- Application manager
supervisor/apps/manager.py - Application lifecycle
supervisor/apps/app.py - Application store
supervisor/store/repository.py - Container management
supervisor/docker/manager.py
Host and system
- Host management
supervisor/host/manager.py - Network settings
supervisor/host/network.py - Hardware management
supervisor/hardware/manager.py - OS management
supervisor/os/manager.py
Data management
- Backup management
supervisor/backups/manager.py - Mount management
supervisor/mounts/manager.py
Integrations
- Home Assistant Core
supervisor/homeassistant/core.py - D-Bus integration
supervisor/dbus/manager.py - System plugins
supervisor/plugins/manager.py - Service management
supervisor/services/interface.py - Network discovery
supervisor/discovery
Other components
- Home Assistant
- Administrator
Connections 32
- Home Assistant → Supervisor API: controls through
- Administrator → Supervisor API: manages through
- Supervisor API → Authentication: validates access
- Supervisor API → Application manager: manages apps
supervisor/api/apps.py - Application manager → Application lifecycle: manages lifecycle
supervisor/apps/manager.py - Application manager → Application store: uses app data
supervisor/apps/manager.py - Application lifecycle → Container management: controls containers
supervisor/apps/app.py - Supervisor API → Network settings: changes settings
- Core orchestration → Supervisor API: initializes
supervisor/coresys.py - Core orchestration → Application manager: initializes
supervisor/coresys.py - Core orchestration → Backup management: initializes
supervisor/coresys.py - Core orchestration → Container management: initializes
supervisor/coresys.py - Core orchestration → Host management: initializes
supervisor/coresys.py - Core orchestration → Hardware management: initializes
supervisor/coresys.py - Core orchestration → OS management: initializes
supervisor/coresys.py - Core orchestration → D-Bus integration: initializes
supervisor/coresys.py - Core orchestration → Home Assistant Core: initializes
supervisor/coresys.py - Core orchestration → System plugins: initializes
supervisor/coresys.py - Core orchestration → Network discovery: initializes
supervisor/coresys.py - Core orchestration → Issue resolution: initializes
supervisor/coresys.py - Core orchestration → Job coordination: provides tasks
supervisor/jobs/decorator.py - Backup management → Application lifecycle: backs up apps
supervisor/backups/manager.py - Host management → Network settings: manages network
supervisor/host/manager.py - Host management → Service management: manages services
supervisor/host/manager.py - Host management → Hardware management: manages hardware
supervisor/host/manager.py - Host management → D-Bus integration: uses D-Bus
- OS management → D-Bus integration: uses RAUC
supervisor/os/manager.py - System plugins → Service management: provides services
- Supervisor API → Backup management: manages backups
- Supervisor API → Host management: manages host
- Supervisor API → OS management: manages OS
- Supervisor API → Mount management: manages mounts