How homebridge/docker-homebridge works
Main Components
a. Container Layer:
• Docker Container (Ubuntu 24.04 base)
• Multi-arch support (amd64, arm32v7, arm64v8)
b. Core Services (represented as individual components):
• Homebridge Core Service
• Homebridge UI (running on port 8581)
• Avahi mDNS Service
• D-Bus Service
• S6 Overlay (process supervisor)
c. Storage/Volume Components:
• Host Volume Mount (/homebridge)
• Configuration Storage
• Plugin Storage
d. Network Layer:
• Host Network Interface (--net=host)
• HomeKit Protocol Interface
• UI Web Interface
Component Relationships
• Docker Host → Container (containment relationship)
• Container → Host Network (direct network access)
• Homebridge Core ↔ HomeKit Devices
• Homebridge Core ↔ Configuration Storage
• Homebridge UI ↔ Web Browsers
• Avahi Service ↔ Network (mDNS broadcasting)
Specific Implementation Details
• Green: Running Services (Homebridge, UI, Avahi)
• Blue: Storage Components
• Yellow: Network Interfaces
• Gray: Infrastructure Components (Docker, S6)
Additional Elements
Annotations for:
• Port mappings (8581 for UI)
• Volume mount points
• Health check endpoint
• Timezone configuration
• FFmpeg support
Architectural Patterns
Highlight:
• Service supervision hierarchy (S6 Overlay)
• Container orchestration
• Plugin architecture
• Configuration management
[Host System Layer]
• ↓
[Docker Container Layer]
• ↓
[Service Layer (S6 Managed)]
• ↓
[Application Layer]
• ↓
[Storage Layer]
Important Implementation Notes:
• Host network mode requirement
• Multi-arch support
• Separation between persistent and ephemeral storage
• UI as the primary management interface
• Health check mechanism