homebridge-prana-local
v0.1.3
Published
Bring compatible PRANA ventilation into Apple Home and Siri over local Wi-Fi, without a PRANA cloud account.
Maintainers
Readme

Homebridge Prana Local
Your PRANA ventilation, in Apple Home.
Control airflow, choose a mode and read your room's sensors. Local Wi-Fi communication. No PRANA cloud account required.
English · Italiano
npm · Get started · Compatibility · Settings · Help
A familiar place for your ventilation
Add a compatible PRANA recuperator to the Homebridge you already use. Apple Home gets a fan, mode switches and the environmental sensors available on your unit. Include these controls in your own Home scenes and automations.
| Airflow | Operating modes | Room conditions | | :--- | :--- | :--- | | On/off and speed control | AUTO and quiet AUTO+ | Indoor and outdoor temperatures | | Optional separate supply/extract controls | Night and Boost presets | Relative humidity | | Synchronized airflow mode | Winter and mini heater switches | Equivalent CO₂ estimate |
Sensor and heater availability depend on the model. See exactly how each control behaves →
flowchart LR
A[Apple Home and Siri] <-->|HomeKit| B[Homebridge · Prana Local]
B <-->|Local Wi-Fi · HTTP| C[PRANA ventilation]Homebridge runs on your always-on host. The plugin talks directly to the PRANA unit; Home Assistant and a Bluetooth gateway are unnecessary. Remote use of Apple Home depends on your Apple home hub and Apple's requirements.
Compatibility
| Component | Evidence | | :--- | :--- | | PRANA 210 G ERP PRO M23 · firmware 49 | Tested on real hardware: sensor readings, speed, power and repeated power commands | | Homebridge 2.4.0 · Node.js 22 | Hardware installation on Raspberry Pi 3 Model B+, 32 bit | | Node.js 22 / 24 / 26 | Automated tests in GitHub Actions | | Homebridge 1.8.5 HomeKit library | Service tests pass with HAP-NodeJS 0.12.3 on Node 22; hardware installation uses 2.4.0 | | Other PRANA models with the same local API | Candidates for community testing; not hardware-verified | | Firmware below 49, Bluetooth-only units | Unsupported by this plugin |
Before installing: your PRANA must be connected to Wi-Fi, expose the local API and run firmware 49 or newer. Check firmware in Prana Online 2.0. A Wi-Fi connection alone does not establish compatibility.
Get started
1. Find the unit
Open your router's connected-device list and find the PRANA's IPv4 address. Reserve that address if your router supports DHCP reservations. Homebridge and the unit must be able to reach one another on the LAN.
2. Install the release
In Homebridge UI → Plugins, search for homebridge-prana-local and install it. The npm package and GitHub release archives contain the same ready-to-run plugin. Follow the installation guide for your Homebridge setup.
3. Add your unit
Open the plugin's Plugin Actions → Plugin Config (or Settings, depending on UI version), add a device and enter its IP address. Choose a permanent ID such as prana-1 and a name such as PRANA ventilation. The name and room are yours to choose; no room is assumed.

The real Homebridge UI, shown with example data in a separate documentation instance. Replace the example address with your unit's address.
Prefer JSON? Copy the minimal configuration. The reference includes multiple-unit examples and every optional setting.
4. Restart and open Apple Home
Restart Homebridge once. Look for connected (firmware …) in the plugin log, then open Apple Home. An already paired bridge carries the new accessory into Home automatically. A new bridge or child bridge needs its own one-time pairing.
Assign the accessory to your chosen room. If controls are grouped, open the accessory settings and choose Show as Separate Tiles, where available.
Read before using the controls
- Manual speed exits AUTO/AUTO+. Home's percentage slider maps to the unit's actual speed steps.
- Night and Boost have explicit exit behavior. Turning Night off selects step 2; turning Boost off selects the step below maximum. Both actions exit automatic modes.
- Startup preserves settings. The plugin reads the unit until you operate a control.
- CO₂eq is an estimate. It is not a direct CO₂ measurement or a safety alarm.
- VOC, pressure, display brightness and sleep timers remain in the manufacturer's app; they are not exposed by this release.
Control behavior and limitations →
Guides and support
| I want to… | Open | | :--- | :--- | | Install, update or remove the plugin | Installation guide | | Configure one or several units | Configuration reference | | Fix “No Response”, missing controls or connection errors | Troubleshooting and FAQ | | Read the guide in Italian | Documentazione italiana | | Report a problem or another supported model | Open an issue | | Contribute code or run checks | Contributing |
Keep the local HTTP API inside a trusted network. It has no authentication and must not be exposed through internet port forwarding. Network details →
Independent community software by viames, under the MIT license. Not affiliated with PRANA or Apple and not verified by Homebridge. Product names belong to their respective owners.
Built using the local API contract described by the PRANA Home Assistant integration and PRANA API client. No Python or Home Assistant runtime is included.
