The HA-Komodo integration connects Home Assistant directly to your Komodo instance, pulling live information about your servers and stacks and organizing them into dedicated devices.
For each server connected to your Komodo instance, a device is created containing key sensors such as stack count, service count, server status, and alert count. For each stack, a dedicated device is created that exposes:
- A status sensor for the stack itself.
- A button entity to deploy the stack.
- A switch entity per service — reflecting the current running state and allowing you to start or stop each service directly from Home Assistant.
- An update entity per service — so you can track and trigger image updates from your dashboard.
This gives you full visibility and basic control over your Komodo-managed infrastructure, all from within Home Assistant.
The easiest way to install the Komodo integration is via HACS.
HACS (Home Assistant Community Store) makes installation and updates simple. Since this is a custom component, you must first add the repository to HACS.
- In Home Assistant, go to HACS.
- Go to the Integrations tab.
- Click the three dots (⋮) in the top right corner and select Custom repositories.
- Enter the URL:
https://github.com/dkarv/ha-komodo - Select Integration as the Category.
- Click ADD.
- After the repository is added, search for "Komodo" in the HACS Integrations section and click Download.
- Restart Home Assistant to load the new integration.
- Download the latest release zip file from the GitHub releases page.
- Extract the contents. You should find a folder named
ha-komodo. - Copy the entire
ha-komodofolder into your Home Assistant configuration directory undercustom_components/.- Resulting Path:
config/custom_components/komodo/
- Resulting Path:
- Restart Home Assistant to load the new integration.
- In Home Assistant, navigate to Settings > Devices & Services.
- Click the + ADD INTEGRATION button.
- Search for "Komodo".
- You will be prompted to enter the following:
- Host: The URL of your Komodo instance (e.g.,
http://192.168.1.100:9120). - API Key: Your Komodo API key.
- API Secret: Your Komodo API secret.
- Host: The URL of your Komodo instance (e.g.,
- Click SUBMIT. The integration will connect to your Komodo instance and create devices and entities automatically.
Once configured, the integration creates one device per server and one device per stack found in your Komodo instance.
Each server gets a device with the following entities:
| Entity | Type | Description |
|---|---|---|
| Server Status | Sensor | The current status of the server (e.g., Ok, NotOk) |
| Stack Count | Sensor | Total number of stacks on the server |
| Service Count | Sensor | Total number of services across all stacks |
| Alert Count | Sensor | Number of active alerts on the server |
Each stack gets its own device with entities for every service it contains:
| Entity | Type | Description |
|---|---|---|
| Stack Status | Sensor | The current state of the stack (e.g., Running, Down) |
Deploy <Stack Name> stack |
Button | Deploys the stack |
<Service Name> |
Switch | Reflects the running state of the service; toggle to start or stop it |
<Service Name> Update |
Update | Tracks available image updates and allows triggering them |
This integration is an independent, community-maintained project and is not affiliated with, endorsed by, or officially associated with the Komodo project or its developers.
In case you have any suggestion or problem, feel free to open an Issue. I'm open to any pull requests with fixes or new features. For bigger changes please approach me beforehand to coordinate.