Skip to content

Initial Release for Kmodo v1.18.4

Choose a tag to compare

@cgfm cgfm released this 09 Aug 13:53
· 5 commits to main since this release

πŸŽ‰ 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 connection
  • passkey: Authentication key for standalone mode
  • monitoring_interval: System monitoring frequency (10-sec to 30-min)
  • container_stats_interval: Container statistics collection frequency
  • ssl_enabled: SSL/TLS encryption toggle
  • Directory management for stacks, repos, and builds
  • Terminal and exec access controls

πŸ“¦ Installation

  1. Add this repository to your Home Assistant Add-on Store:
    https://github.com/cgfm/Komodo-Periphery-Addon
    
  2. Install the "Komodo Periphery" add-on
  3. Configure according to your needs (standalone or core connection mode)
  4. 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: false

Standalone 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