Skip to content

Breeze Core v3.0.1

Choose a tag to compare

@github-actions github-actions released this 23 Jul 13:10
· 81 commits to main since this release

Breeze Core 3.0.1 — the first stable of the 3.0 line. Self-hosted, LAN-first REST API + web control panel + diagnostic CLI for Midea air conditioners. No cloud after pairing.

Highlights of the 3.0 line

  • Ed25519 request signing (auth v2). Every request is signed with a key generated on the device that never leaves it; the server stores only the public key, so a server compromise leaks nothing forgeable. Existing bearer-token (v1) devices keep working and upgrade themselves in place; set AC_MIN_AUTH_VERSION=2 to require v2.
  • Network scan-to-add. GET /api/units/scan finds units by their open ports across the server's private subnet, so the app and web UI can add units without typing IPs.
  • Per-command beep. beep is an optional control field now (silent by default — schedules and older clients stay quiet).
  • New read endpoints: per-unit capabilities (clients hide controls the hardware lacks), whoami (the calling device's own credential + expiry), state history, and a Prometheus /metrics endpoint served from last-known state (it never triggers a live LAN fetch, so scrapes can't hammer the units).
  • Live updates over SSE. GET /api/units/stream pushes state changes — including ones made by a schedule or another client — so clients can stop polling.
  • Fuller diag. Adds a host-local background-service check (is it running? enabled at boot?) across systemd / OpenRC / runit / procd / Windows.

New in 3.0.1

  • BSD packages. FreeBSD and NetBSD install from a private virtualenv (the Linux self-contained bundles can't run on a BSD kernel), verified end-to-end on real FreeBSD 15.1 and NetBSD 10.1 — installer, rc.d service, and health check. FreeBSD ships a native .pkg and a signed pkg repo; NetBSD a binary package + pkgin repo. Fixed an rc.netbsd bug (pidfile/log written as the unprivileged user → permission denied) caught during live testing.

Install

Add the signed repository once — copy-paste setup per distro at https://bolero.salataputarica.hr.eu.org (apt · dnf/zypper · pacman · apk · opkg · FreeBSD pkg · NetBSD pkgin). One-off downloads are the assets below; Docker is ghcr.io/monikapurpl3/breeze-core:3.0.1. Full guide: docs/PACKAGES.md.

Every Linux artifact here is built and install-tested across 15 distro userlands in CI before release.