Skip to content

Configuration

Jump to bottom
mxkissnr edited this page May 23, 2026 · 2 revisions

Language: English | Deutsch

Installation & Configuration

Prerequisites

  • Gaggiuino controller reachable via HTTP from the Home Assistant host
  • Gaggiuino HA integration installed (optional — required for auto-sync via latest_shot_id)

Verify connectivity from the HA terminal:

curl http://<gaggiuino-ip>/api/shots/latest

Installation

  1. Open Home Assistant → Settings → Add-ons → Add-on Store
  2. Click ⋮ → Repositories and add: https://github.com/mxkissnr/gaggiuino-local-profiler
  3. Find Gaggiuino Local Profiler and click Install
  4. Configure the options (see below)
  5. Click Start → Open Web UI

Options

Option Description Default
machine_url API URL of the Gaggiuino controller http://gaggia.intern/api/shots
sync_interval Auto-sync interval in minutes (1–60) 5
switch_entity HA switch entity to power the machine on/off (empty)

Example

machine_url: "http://192.168.1.42/api/shots"
sync_interval: 5
switch_entity: "switch.espresso_plug"

Smart Plug (optional)

When switch_entity is configured, a ⏻ power button appears in the sidebar footer:

  • Green → machine is on
  • Grey → machine is off
  • Click to toggle the switch via the HA API

The Live tab is automatically disabled when the machine is off — no pointless connection attempts.

Auto-Sync

The add-on checks sensor.gaggiuino_latest_shot_id every 30 seconds in the background. When the sensor value rises, a sync is triggered automatically. This requires the Gaggiuino HA integration.

Without the integration, shots can still be synced manually via the ↻ Sync button or on the configured interval.

Clone this wiki locally