Repository navigation
Initial Release for Kmodo v1.18.4
π Initial Release - Komodo Periphery Home Assistant Add-on for Komodo v1.18.4
This is the first official release of the Komodo Periphery Home Assistant Add-on!
π What's New
Core Features
- π³ Docker Container Management: Full Docker container lifecycle management
- π Core Connection: Seamless WebSocket connection to Komodo Core servers
- π Container Statistics: Real-time monitoring with configurable intervals
- π Secure Authentication: Support for passkey-based authentication
- π Stack Management: Deploy and manage Docker Compose stacks
- ποΈ Build Support: Build Docker images from repositories
- π SSL Support: Optional SSL/TLS encryption
- π Repository Management: Git repository integration
Technical Highlights
- Multi-Architecture Support: Native support for amd64 and aarch64
- Debian Base: Uses Debian bookworm-slim for better glibc compatibility
- s6-overlay Integration: Professional service management
- bashio Integration: Full Home Assistant Add-on standards compliance
- Docker Integration: Native docker.io package integration
- Health Checks: Comprehensive monitoring and health verification
Configuration Options
core_url: WebSocket URL for Core server connectionpasskey: Authentication key for standalone modemonitoring_interval: System monitoring frequency (10-sec to 30-min)container_stats_interval: Container statistics collection frequencyssl_enabled: SSL/TLS encryption toggle- Directory management for stacks, repos, and builds
- Terminal and exec access controls
π¦ Installation
- Add this repository to your Home Assistant Add-on Store:
https://github.com/cgfm/Komodo-Periphery-Addon - Install the "Komodo Periphery" add-on
- Configure according to your needs (standalone or core connection mode)
- Start the add-on
π§ Quick Start
Core Connection Mode:
core_url: "ws://your-core-server:9120"
monitoring_interval: "30-sec"
container_stats_interval: "1-min"
ssl_enabled: falseStandalone Mode:
passkey: "your-secure-passkey"
monitoring_interval: "30-sec"
container_stats_interval: "1-min"
ssl_enabled: trueπ Requirements
- Home Assistant OS or Supervised
- Docker access
- Port 8120 available
- Network access to Docker socket
π Known Issues
- SSL certificates must be manually configured if SSL is enabled
- Some container statistics require privileged access
π Support
Got questions? Open an issue
Full Changelog: https://github.com/cgfm/Komodo-Periphery-Addon/blob/main/CHANGELOG.md