ReefMind wiki

Plain-language setup and troubleshooting guides for connecting a reef tank, checking whether readings are current, reviewing history, configuring alerts, using cameras, and understanding ReefMind integrations.

Quickstart

1. Create or sign in to your ReefMind account.
2. Add a tank and choose the connection path: Apex, Hydros, Aquarino, Collector Box, Jebao, automated testers, or manual-first.
3. Confirm the dashboard shows readings or a clear next step.
4. Open Water History after readings arrive to review trends and manual logs.
5. Enable alerts only after the tank has enough reliable data to avoid noisy false positives.

Accounts & tanks

A ReefMind account can contain multiple tanks. Each tank keeps its own controller connection, Collector Box assignment, readings, manual logs, dosing context, camera settings, and alert preferences.

Controllers

Controller connections are read-oriented by default. ReefMind should tell you the source of each reading and whether it is current or last-known.

• Apex / Fusion: connect using Fusion sharing or supported local Apex paths.
• Hydros: share the controller with ReefMind and verify read access.
• Aquarino: connect cloud readings or pair through a Collector Box for local collection.
• Jebao dosing: map read-only dosing channels to the correct tank and substance.

Automated Testers

Automated Testers are lab-style integrations that add water test results to ReefMind history after you choose the matching tank.

• Focustronic: a read-only OAuth connection. You authorize once, ReefMind stores only a server-side credential reference (never your password or raw token), then imports test history for the tank you pick. ReefMind reads each unit by its official Focustronic device class and never reads one class through another class's endpoint.
• Alkatronic: imports alkalinity (dKH) and pH.
• Mastertronic and Mastertronic Essential: import NO3, PO4, calcium, magnesium, and alkalinity. Both share the Mastertronic device class; ReefMind labels which model you linked.
• Raw read-only extras: OLI, NO2, NH4, Fe, and I are imported but kept raw and read-only — no alerts and no Captain Chris analysis — until reef semantics for them are defined.
• Discovery-only: Dosatronic/Dosetronic and other Focustronic classes stay read-only and are not imported until a read-only records endpoint is documented.
• What ReefMind never does: it does not control Focustronic units, dosing, schedules, correction logic, or the Focustronic app, and never writes back to your devices.

Collector Box

The Collector Box runs at the tank and keeps ReefMind connected to supported local devices. Use it when you need local controller access, camera/local network paths, or more frequent collection than a cloud-only integration provides.

Setup checklist

• Power on the Collector Box near the tank.
• Connect Wi‑Fi or use AP mode if the box has not joined your network yet.
• Assign the Collector Box to the correct tank in ReefMind.
• Verify the collector heartbeat and the specific controller status.

Readings & freshness

Current parameter cards should show the value, unit, source label, and age of the reading. If ReefMind only has an old value, it should be presented as last-known rather than live.

• Live: recent data from a controller, Collector Box, or manual log.
• OK: usable data within the expected polling window for that source.
• Stale / dead: last-known value is old and should not be treated as current.
• No data: ReefMind does not yet have enough readings for that parameter or tank.

Common parameters include temp, ph, alk, salinity, no3, po4, calcium, magnesium, orp, and co2.

Water History

Water History shows parameter trends over time. Use it to compare manual tests, controller readings, dosing changes, and reefkeeping events. Short ranges help diagnose recent swings; longer ranges help spot drift.

Manual logs

Manual logs are for test kits, observations, maintenance, and notes. Keep the raw number and unit you measured. ReefMind can normalize display later, but the original observation should stay intact.

Alerts

Alerts should be practical and explain the data freshness. A missing-data alert is different from a bad-parameter alert. If a controller is offline or data is stale, check the source connection before taking action on an old value.

Dosing Intelligence

Dosing Intelligence connects dosing activity with water chemistry. Supported dosing paths should remain read-only unless ReefMind explicitly says a safe write path is available.

• Map each channel to the correct tank and substance.
• Review daily totals and dosing history.
• Compare dosing changes to alkalinity, calcium, magnesium, nitrate, phosphate, and pH trends.

Camera & live view

Camera features depend on the camera model, network path, and browser playback support. If live view does not start, verify that snapshots work first, then check Collector Box reachability and camera credentials.

Troubleshooting

Dashboard says data is stale

• Check whether the controller/cloud provider is online.
• Confirm the tank is assigned to the right Collector Box if local collection is expected.
• Refresh the dashboard and compare the reading source/age.

Tank or controller looks wrong

• Confirm you selected the intended tank from the tank switcher.
• Look for duplicate or old tank names that may have stale settings.
• Send support the tank name, controller type, and a screenshot.

Support

For support, email support@reefmind.ai or join the ReefMind Discord from the app. Include enough context for the team to reproduce the issue: account email, tank name, controller type, and the page where the problem appears.