Home Assistant on Another Computer
4 minute read
If Home Assistant runs somewhere other than the Exaviz board, for example on a mini PC or in a container on your server, the integration can reach the board over your network. This needs version 1.4.0 or newer of the Exaviz integration.
What You Need
- An Exaviz Cruiser. Interceptor boards cannot be added over the network yet.
- Exaviz Management on the board, with Home Assistant pairing (More > Home Assistant in the board’s dashboard). If the board’s Exaviz Management is too old, Home Assistant tells you to update it.
- One board per Home Assistant for now.
The computer that runs Home Assistant does not need the Exaviz packages. Install the integration from HACS as described in Installation.
Add the Board
- In Home Assistant, go to Settings > Devices & services > Add integration, search for Exaviz, and choose The board is another device on my network.
- Enter the board’s IP address. A
.localname works only where your system resolves it; use the IP address if it does not. Leave the HTTPS port at 443 unless you changed it on the board. - On the board, open More > Home Assistant and click Add Home Assistant. Choose Read + PoE control if you want to switch ports from Home Assistant, or Read only if you only want to watch them. The code is valid for 5 minutes.
- Home Assistant shows the board’s certificate fingerprint. Compare it with the Fingerprint on the board’s pairing screen. Tick The fingerprints are the same only if they match. If they do not, untick it and submit: nothing is paired. Check that you entered the right board’s address.
- Enter the 8-character code from the board’s pairing screen, like
ABCD-EFGH.
The board then appears in Home Assistant with the same entities as a board that runs Home Assistant itself. See Configuration.
From version 1.4.1 it also gets a Zigbee Radio sensor (sensor.zigbee_radio) that shows
whether the board’s Zigbee radio service is running: On, Off, Starting or
Failed. It shows Unknown when the board could not read the service, and is unavailable
when the service is not installed or the board’s Exaviz Management does not report it. See the Zigbee page.
Read Only or PoE Control
| Board setting | What Home Assistant can do |
|---|---|
| Read only | See ports, power and board status. The port switches and reset buttons are unavailable. |
| Read + PoE control | Also turn PoE ports on and off and power-cycle them. |
Neither setting lets Home Assistant change the board’s settings or passwords.
To move from read only to PoE control, pair again: revoke the old token on the board,
start a new pairing with Read + PoE control, and enter the new code when Home
Assistant asks for it. The sensor.board_status entity shows the current setting in its
pairing_scope attribute.
Security
- The integration talks to the board over HTTPS only. On every connection, before it sends anything, it checks the board’s certificate against the one you confirmed. It never falls back to an unchecked connection. If the board uses a certificate from a public certificate authority, a renewed certificate with the same key is accepted.
- If the board’s certificate changes, Home Assistant stops reading the board and asks you to re-authenticate the Exaviz integration under Settings > Devices & services. The form that opens is Pair with the board again: select Submit, then compare the new fingerprint with the board before you enter a new code.
- Home Assistant keeps the pairing token in its configuration files and backups as plain text, not encrypted. Anyone who can read your Home Assistant configuration can read it. The token never appears in Home Assistant’s logs.
Tokens and Revoking
- Each pairing creates a new token. The board lists them under Paired Home Assistants in More > Home Assistant, with the token id under each name.
- The board holds at most 20 Home Assistant tokens. When it is full, pairing fails with a message; revoke an unused token on the board and enter the same code again.
- Removing the integration from Home Assistant does not revoke its token. Revoke it on the board.
- If you revoke the token Home Assistant is using, Home Assistant asks you to pair again the same way.
- After pairing again, revoke the old token on the board. Home Assistant shows you its id.
When Something Changes
- The board has a new address: open the Exaviz integration in Home Assistant and choose Reconfigure. Enter the new address. If the board’s certificate also changed, you compare the new fingerprint and pair again.
- The board’s serial number changed: delete the integration and add it again. The default entity ids stay the same, but renames or other changes you made to the entities in Home Assistant must be made again.
- The board does not answer: its entities become unavailable until it answers again. A single port whose readings stop updating also shows as unavailable. The PoE card currently shows such a port as empty.
Last modified November 12, 2026