Integrating De'Longhi Coffee Machines into Home Assistant: Local LAN & Cloud with CremaLink HA

Midian — Mon, 09 Nov 2026 17:36:16 +0000

Most smart coffee machines live behind restrictive vendor apps or lack proper Home Assistant integration entirely. To fix this, I built cremalink for Home Assistant.

It connects Home Assistant to the broader Cremalink ecosystem, enabling real-time state monitoring and control of IoT coffee machines directly from your dashboard.

How It Works

The setup is built as a modular architecture consisting of two components:

cremalink-ha: Acts strictly as the bridge into Home Assistant, exposing native entities, controls, and states.
Cremalink Server Add-on: Runs alongside Home Assistant (required for local connection) and handles communication with the machine.
Core Device Management: Handled via the upstream cremalink engine. You set up your machine configurations there first, and this integration surfaces them inside HA.

Note on Hardware: The project was developed with a practical, result-oriented approach and is currently optimized around the De'Longhi PrimaDonna Soul. The underlying architecture is built to be extensible, with the goal of making the engine fully generic for other machines.

Getting Started

1. Install the Server Add-on (Local Connections)

Before setting up the integration, install and configure the Cremalink Server Add-on:

Add-on Documentation & Setup Guide

2. Install the Integration

Via HACS:

Add https://github.com/miditkl/cremalink-ha as a custom repository in HACS (Category: Integration).
Search for Cremalink and hit install.
Restart Home Assistant.

Manual:
Copy the custom_components/cremalink_ha folder directly into your Home Assistant config/custom_components/ directory and restart.

3. Configuration

In Home Assistant, go to Settings > Devices & Services.
Click Add Integration and search for Cremalink.
Follow the UI setup flow and provide the connection details for your Cremalink Server Add-on instance.

Contributing & Project Links

If you want to integrate a machine profile that isn't supported yet or help decouple model-specific logic, contributions are very welcome:

HA Integration & Add-on: github.com/miditkl/cremalink-ha
Core Project & Wiki: github.com/miditkl/cremalink (guidelines on adding machine definitions)
License: AGPL-3.0-or-later