cremalink-ha
cremalink Server HA Add-on
Run the local Cremalink server directly within Home Assistant to bridge your coffee machine.
✨ Overview
This Home Assistant Add-on runs the Cremalink Server, which communicates directly with supported coffee machines over the local network. It exposes an API that the Cremalink Integration uses to monitor and control the machine.
[!NOTE] This project was developed with a result-oriented approach, primarily optimized for the De’Longhi PrimaDonna Soul. While the architecture is designed to be extensible, some logic may currently be tightly coupled to this specific model.
The goal is to make the library fully generic. If you encounter issues with other machines, contributions are highly encouraged!
[!NOTE] cremalink-ha acts solely as a bridge to Home Assistant. Device management (e.g., adding new machines) is handled exclusively via the main cremalink project. Please set up your devices there before using this integration.
🚀 Installation & Configuration
1. Installation
- Click the badge above or navigate to Settings > Add-ons > Add-on Store.
- Add the repository URL:
https://github.com/miditkl/cremalink-ha - Install Cremalink for Home-Assistant.
- Start the add-on.
2. Configuration
Configure the add-on via the Configuration tab.
| Option | Description | Default |
|---|---|---|
advertised_ip |
(Optional) The IP address to advertise for the server. | Empty |
server_port |
The port the server will listen on. | 10280 |
monitor_poll_interval |
Interval (in seconds) to poll the machine status. | 1.0 |
log_level |
Logging verbosity (debug, info, warning, error). |
info |
🛠 Usage
Once running, this add-on handles the low-level communication with the coffee machine.
To control the machine from Home Assistant, you must also install the Cremalink Integration.
👉 Go to Integration Documentation for next steps.
📄 License
Distributed under the AGPL-3.0-or-later License.
Developed by Midian Tekle Elfu. Supported by the community.