Skip to content

Link Your Hub

Linking connects the Pi to your ChillCheck cloud account so sensor readings are stored, alerts are sent, and you can manage everything from the dashboard.

Step 1 — Generate a pairing code

  1. Log in to app.chillcheck.online
  2. Go to Settings → Devices
  3. Click Pair a Pi
  4. You'll see an 8-character pairing code, e.g. WOLF-4821

Codes expire after 10 minutes

If the code expires before you use it, simply generate a new one. Each code can only be used once.

Step 2 — Enter the code in the hub UI

  1. Open http://chillcheck.local in a browser on the same network as the Pi
  2. You should be on the Cloud Link tab
  3. Optionally enter a site name (e.g. "Pup Planet Wolverhampton") — this is how the site will appear in your dashboard
  4. Type or paste the pairing code
  5. Click Link this Pi →

If successful, the page will update to show "Connected" with your organisation and site name.

What happens during linking

When you enter the pairing code, the Pi contacts the ChillCheck API, which:

  1. Validates the code and marks it as used
  2. Creates a device record in your account
  3. Writes your organisation credentials (SUPABASE_URL, ORGANISATION_ID, SITE_ID, DEVICE_ID) to /etc/chillcheck/.env on the Pi
  4. Restarts the subscriber service so it picks up the new credentials

From this point, sensor readings from this hub will appear in your dashboard under the linked site.

Troubleshooting pairing

"Invalid or expired code" : The code was entered incorrectly or has expired (10-minute limit). Generate a new code in Settings → Devices and try again.

"This Pi is already linked" : The Pi was previously linked to an account. To re-link to a different account, disconnect first via the local hub UI, then pair again.

Page shows an error instead of "Connected" : Check that the Pi has internet access. On the Network tab of the hub UI, confirm a connection is shown. If offline, resolve the network issue first.

Next step

Add sensors →