Local Hub UI¶
The local hub UI is a web interface served directly from the Raspberry Pi at:
It is accessible from any device on the same local network as the Pi — laptop, phone, or tablet. No internet connection is required to use it.
Hub UI scope
The local UI handles sensor pairing and hub health only. Cabinet creation, sensor assignment, alert rules, and team management are all done in the cloud dashboard at app.chillcheck.online.
Tabs¶
Cloud Link¶
Shows whether this hub is linked to your ChillCheck account.
Not linked: - Enter a pairing code from Settings → Devices in the cloud dashboard - Optionally enter a site name before submitting - See Linking your hub for step-by-step instructions
Linked: - Shows your organisation name and site name - Link to open the cloud dashboard - Option to disconnect (stops the hub syncing readings — use with caution)
Sensors¶
Lists all sensors that have been paired with this hub.
Unassigned sensors (amber dashed border): - Recently paired sensors that haven't been assigned to a cabinet yet - Click Assign → to assign to an existing cabinet - To create a new cabinet, go to the cloud dashboard
Assigned sensors (grid table): - Cabinet name, sensor ID, signal strength, battery level, and last-seen time - Unassign button removes the sensor from its cabinet (alerting stops immediately)
Pairing a new sensor: Click + Pair sensor and follow the on-screen steps. See Adding sensors.
Signal strength indicators:
| Bars | Signal | Approximate RSSI |
|---|---|---|
| 3 bars (green) | Good | > -55 dBm |
| 2 bars (green) | Fair | -55 to -70 dBm |
| 1 bar (green) | Weak | < -70 dBm |
| 0 bars (grey) | No signal / offline | — |
Battery indicators:
| Colour | Level |
|---|---|
| Green | > 60% |
| Amber | 30–60% |
| Red | < 30% — replace soon |
Network¶
Shows the current network connection status and lets you configure Wi-Fi.
- Connected network: IP address, gateway, and mDNS hostname (
chillcheck.local) - Ethernet: shows whether eth0 is plugged in
- Wi-Fi scan: click Scan to discover available networks, then click Connect next to one to enter the password
Ethernet first
ChillCheck works best with ethernet. Wi-Fi can be configured here as a backup, but ethernet is more reliable for 24/7 operation in commercial premises.
System¶
Shows hub health and lets you manage software updates and services.
Services:
| Service | Purpose |
|---|---|
chillcheck-subscriber |
Reads sensor readings from MQTT, writes to cloud, fires alerts |
chillcheck-local-ui |
Serves this web interface |
mosquitto |
MQTT broker (local message bus) |
zigbee2mqtt |
ZigBee USB dongle bridge |
All four should show running in green. A service showing down in red means it has stopped unexpectedly — click Restart to bring it back. If it fails to stay running, see Troubleshooting.
Software updates:
The System tab shows your currently installed firmware version and whether a newer version is available. Click Install to apply an update. The hub will:
- Download the latest code from the ChillCheck mirror
- Stop services briefly (~30 seconds)
- Apply the update and restart services
- Roll back automatically if services fail to come up after the update
Updates take ~60 seconds
Temperature monitoring pauses during an update. The page will reload automatically once the update is complete.
Disconnecting from cloud¶
To unlink the hub from your account:
- Go to the Cloud Link tab
- Click Disconnect from Cloud
- Confirm
This stops the hub syncing readings and removes the cloud credentials from the Pi. To re-link, generate a new pairing code in the cloud dashboard and follow the linking steps again.
Disconnecting stops all monitoring
Once disconnected, no readings are stored in the cloud and no alerts will be sent. Reconnect as soon as possible.