naklma/ariston-net-loxone repository overview

⁠Ariston NET → Loxone (microservice)

Model tested: Ariston Velis Dune WiFi · Wraps the reverse-engineered python-ariston-api⁠ (MIT).

⁠🇬🇧 English

A small, self-hosted microservice to control an Ariston NET water heater (boiler) from Loxone — and from any HTTP client. It exposes a clean REST API plus a plain-text interface built for the Loxone Miniserver (Virtual HTTP Inputs / Virtual Outputs).

Features

• 🏠 Loxone-ready: bare-value reads for Virtual Inputs, GET commands for Virtual Outputs
• 🌡️ Read sensors: current/target temperature, heating, ECO, ready showers, energy
• 🎛️ Control: set temperature, mode (MANUAL/PROGRAM/BOOST), power, ECO, anti-legionella, max setpoint
• 🔎 List devices + hardware/identity info
• 🔐 Optional API key (header / query / HTTP Basic)
• 🐳 Runs in Docker; unit tests never touch the real cloud

Run

docker run -d --name ariston-api -p 8000:8000 \
  -e ARISTON_USERNAME="[email protected]" \
  -e ARISTON_PASSWORD="your-password" \
  USER/ariston-net-loxone:latest

curl http://localhost:8000/health
curl http://localhost:8000/devices            # find your gateway id (gw)
curl http://localhost:8000/devices/default    # full state

Interactive docs at http://localhost:8000/docs. ⚠️ This controls a real appliance — writes take effect on the boiler.

⁠🇨🇿 Česky

Malá, self-hosted mikroslužba pro ovládání bojleru Ariston NET z Loxone — i z libovolného HTTP klienta. Nabízí čisté REST API a navíc plain-text rozhraní přímo pro Loxone Miniserver (Virtuální HTTP vstupy / Virtuální výstupy).

Co umí

• 🏠 Připraveno pro Loxone: čtení vrací holou hodnotu (Virtual Input), příkazy přes GET (Virtual Output)
• 🌡️ Čtení senzorů: aktuální/cílová teplota, ohřev, ECO, počet sprch, spotřeba
• 🎛️ Ovládání: nastavení teploty, režimu (MANUAL/PROGRAM/BOOST), zapnutí, ECO, anti-legionella, max. setpoint
• 🔎 Výpis zařízení + info o HW/identifikaci
• 🔐 Volitelný API klíč (hlavička / query / HTTP Basic)
• 🐳 Běží v Dockeru; unit testy se nikdy nedotknou reálného cloudu

Spuštění

docker run -d --name ariston-api -p 8000:8000 \
  -e ARISTON_USERNAME="[email protected]" \
  -e ARISTON_PASSWORD="tvoje-heslo" \
  USER/ariston-net-loxone:latest

curl http://localhost:8000/health
curl http://localhost:8000/devices            # zjisti gateway id (gw)
curl http://localhost:8000/devices/default    # kompletní stav

Interaktivní dokumentace na http://localhost:8000/docs. ⚠️ Ovládá reálný spotřebič — zápisy se projeví na bojleru.

⁠Environment variables

⁠Loxone (examples)

GET /loxone/default/temp      -> 72.0        (Virtual HTTP Input)
GET /loxone/default/status    -> key: value lines
GET /loxone/default/set/temperature/60       (Virtual Output)

Source & docs: https://github.com/MANARA-Technologies/LOXONE-bridge-ARISTON-NET⁠ · License: MIT · Not affiliated with Ariston; uses an unofficial API — use at your own risk.