Homeowner

Home Assistant integration for HAVEN IAQ

Last updated Nov 5, 2026

Connect your HAVEN air quality monitor using the built-in HAVEN IAQ integration, rated Silver quality by Home Assistant.

It communicates over your local network without a separate broker or custom integration.

Before you start

Home Assistant 2026.11 or later.
Room Air Monitor: firmware V19 or later.
Central Air Monitor: firmware 2.5.1 or later.
Your monitor must be connected to Wi-Fi. Keep it on the same local network as Home Assistant, which can use Wi-Fi or Ethernet.
Home Assistant must be enabled on your HAVEN monitor.

Automatic discovery uses mDNS to advertise the monitor's Local HTTP service on your network. mDNS helps Home Assistant find a monitor that is already connected; it does not replace the monitor's Wi-Fi connection.

About the current HAVEN app

On supported firmware, the Home Assistant setting enables the monitor's Local HTTP connection. The current app still checks fields from the older MQTT setup before it will save, even though Local HTTP does not use those broker credentials.

If Home Assistant is already enabled on your monitor, continue with the steps below. You do not need to replace existing saved values.

If you are enabling it for the first time, enter placeholder values in the required legacy fields so the app can save:

Host Name: homeassistant.local
Port: 1883
Username: non-empty dummy text
Password: non-empty dummy text, not a real account password

These are placeholders for the HAVEN app only, not connection settings for the official integration. Local HTTP does not use these broker fields, and you do not need to set up an MQTT broker. Enable Home Assistant and save the settings, then continue below. The integration itself connects to your monitor over HTTP port 80.

If the app still will not save, contact HAVEN Support for help.

Add your monitor to Home Assistant

Open Settings > Devices & services in Home Assistant.
Find your discovered HAVEN monitor and select Add.
Follow the prompts to finish setup, then open the device page to check its readings.

If your monitor is not discovered

Select Add integration > HAVEN IAQ and enter your HAVEN monitor's hostname or IP address.

The monitor uses HTTP port 80. You normally enter only its hostname or IP address; the integration does not ask for a separate port, MQTT username, or MQTT password.

Available readings

The measurements available depend on your monitor model. CO2 measurement is available on the Room Air Monitor only. The Central Air Monitor does not measure CO2.

Supported readings in the official HAVEN IAQ integration
Reading	Room Air Monitor	Central Air Monitor
Temperature	Yes	Yes
Humidity	Yes	Yes
Carbon dioxide (CO2)	Yes	Not measured
Dew point	Yes	Not provided
VOC	Index	ppb
NOx index	Yes	Not provided
PM mass	PM1.0, PM2.5, PM4.0, PM10	PM2.5, PM10
Particle count	PM0.5, PM1.0, PM2.5, PM4.0, PM10	PM2.5, PM10
Pressure	Not provided	Yes
Airflow	Not provided	Yes
Airflow duration	Not provided	Yes

VOC is reported as an index by the Room Air Monitor and as a concentration in parts per billion (ppb) by the Central Air Monitor. PM mass means particle mass concentration.

Home Assistant requests updated readings once per minute. Use the readings in dashboards, history charts, and automations. This integration provides monitor readings, not HAVEN Controller control.

Enable particle-count data

Particle-count data is disabled by default in Home Assistant.

Open your HAVEN monitor's device page and select the link showing its disabled entities.
Select the particle-count entity you want to enable, then open its Settings.
Turn Enabled on and select Update. Follow any restart prompt shown by Home Assistant.
Repeat for any other particle-count entities you want to use.

See Home Assistant's instructions for enabling an entity.

Moving from an older HAVEN setup

The official integration uses Local HTTP instead of the older Local MQTT method. Supported Room Monitor firmware replaces the old Local MQTT path, so older MQTT entities may have stopped updating. This is not an automatic conversion of your existing Home Assistant entities.

Back up Home Assistant. Record your old HAVEN entity IDs and the dashboards, automations, and scripts that use them.
If you have an older HAVEN custom integration, disable only the old monitor's entry before adding the same monitor to the built-in integration. Do not run both monitor entries at once.
Add the monitor using the official HAVEN IAQ integration and confirm that its readings update.
Update dashboards, automations, and scripts to use the new entities. Do not assume that entity IDs or recorded history transfer automatically.
Once you have verified the replacement, remove the obsolete HAVEN-specific monitor entries. If no remaining devices depend on the old HAVEN custom integration, remove that package from Marketplace (formerly HACS) and follow its restart instructions.

Keep shared services and Controller support. Do not remove the shared MQTT broker, Home Assistant's MQTT integration, or a broker user if other devices still use them. If the older HAVEN custom integration also controls a HAVEN Controller, do not uninstall the whole integration: keep the Controller-dependent part until a supported replacement is available.

Troubleshooting

Nothing is discovered: check the monitor's power, Wi-Fi, firmware, and Home Assistant setting. Guest-network isolation or blocked multicast can prevent discovery; try manual setup if the monitor is reachable.
Readings are unavailable: confirm that Home Assistant can still reach the monitor at its configured hostname or IP address. Check whether the monitor's address changed.
Particle counts are missing: enable the disabled particle-count entities using the steps above.
The HAVEN app will not save: complete the required legacy fields with placeholder values as described above, including a valid port. Local HTTP does not use those broker credentials. If saving still fails, contact HAVEN Support.

Keep the monitor's local HTTP service private to your home network. No router port forwarding is needed. Do not expose the monitor's HTTP port to the public internet.

For Home Assistant setup details, see the official HAVEN IAQ integration documentation. If you need help enabling the setting in the HAVEN app, contact HAVEN Support.