Reef Trak Home Assistant bridge icon Home Assistant Bridge

See your tank from anywhere.Beta

Your smart plugs, heaters, temperature probes, and leak sensors already talk to Home Assistant. Connect them to Reef Trak and your tank's equipment shows up in the app, at home or away, with live readings and 7-day trends. New in this release: Neptune Apex support brings your Apex probes along too.

Reef Trak and Home Assistant working together

Local control, with confirmation.

Node One can turn supported Home Assistant switch entities and compatible smart plugs on or off from the appliance or its local browser. It confirms the reported state and uses power feedback where available, without automatically retrying a command. Only the devices you pick leave your house, outbound over HTTPS. No open ports, and your Home Assistant stays private.

This is a beta

We are testing the bridge with a small group. Expect rough edges: data flow can pause while we fix things, and screens will keep improving. Nothing the bridge sends only the actions you explicitly request to supported equipment. Found something odd? Tell us at support@reeftrak.com.

Install in about five minutes

Want every detail first? Read the full setup guide: how the bridge works, what it does and does not do, and the limits of this first beta.

You need Home Assistant 2025.6 or newer, and the Reef Trak app with Premium. The Home Assistant connection is a Reef Trak Premium feature.

1
Open a terminal on your Home Assistant

Home Assistant installs vary, so go by what your own Settings screen shows, not by what hardware you own.

If Settings has an Apps section (called Add-ons on older versions): first click your username at the very bottom of the left sidebar and turn on Advanced Mode. Then open Settings > Apps, press the Store button, install Terminal & SSH, and start it. Terminal appears in the sidebar.

If Settings has no Apps section (Settings > About says Home Assistant Container): there is no app store, and that is normal. Open a shell on the container from the machine that runs it, then use the same command. Examples: TrueNAS: Apps > Home Assistant > Shell. unRAID: Docker tab > container > Console. Synology: Container Manager > container > Terminal. Plain Docker: docker exec -it homeassistant bash.

Already have SSH access? That works too, on any install type.

2
Paste this one command

curl -sSL https://reeftrak.com/homeassistant/install | sh

It finds your config folder and puts the integration where it belongs, on any platform: Raspberry Pi, NAS, Docker, anything running Home Assistant.

3
Restart Home Assistant

Settings > System > Restart.

4
Get a pairing code from the Reef Trak app

Open your tank, tap the house icon, then Pair through Reef Trak cloud. A six-character code appears. Codes last an hour; make a new one anytime.

5
Add the integration, enter the code, pick your devices

In Home Assistant: Settings > Devices & Services > Add Integration > Reef Trak. Enter the code, then the same flow shows your devices as a checkbox list: tick the ones that belong to this tank and press Submit. The readings screen comes pre-selected, so most people just press Submit again. Only real readings are offered; technical clutter is filtered out automatically.

6
Watch your tank come alive in the app

Readings arrive within seconds of finishing. Charts draw themselves in as history builds. Change your device picks anytime with the integration's Configure button.

Prefer to install by hand?

Download the zip and unzip it into the folder that holds your configuration.yaml: it adds custom_components/reeftrak and custom_components/reeftrak_apex folders. The Samba share or File editor apps both work. Then continue from step 3.

Questions people ask

What data leaves my house?

Only the devices you pick during setup, and only their readings: state, value, unit, and a small set of display details like fan speed or brightness. Never your camera feeds, never room names, never your full device list, never your Home Assistant login.

Can Node One turn my equipment on or off?

Yes, for supported switch entities and compatible smart plugs or pumps. Control runs locally from Node One, confirms the reported state, uses power feedback where available, and never retries a command automatically.

Do I need to open a port or set up a VPN?

No. Your Home Assistant pushes readings out over HTTPS, the same direction your browser talks to any website. Nothing from the internet can reach in.

How do I disconnect?

Either side works: remove the integration in Home Assistant, or in the Reef Trak app open the Home Assistant menu and choose Connected bridges > Revoke access. Revoking cuts data flow immediately.

How do I update the integration?

During the beta, run the install command again: it replaces the integration with the newest version. Then restart Home Assistant. Your pairing and device choices survive updates.

I have a Neptune Apex. Does it work with this?

Yes. The install now includes Reef Trak Apex, a second integration that reads your Apex directly on your home network: pH, ORP, temperature, and per-outlet power all become Home Assistant sensors. Add it under Settings > Devices & Services > Add Integration > Reef Trak Apex, then pick those sensors during bridge pairing like any other device. Reading only, like everything else here: your Apex programming is never touched.

Which Home Assistant versions work?

Home Assistant 2025.6 or newer, on any install type: Home Assistant OS (including Yellow and Green), a Raspberry Pi, Docker, unRAID, a NAS, anything. The bridge is the same code everywhere.