Skip to content

First Boot & Network Setup

After powering on the Pi for the first time, you'll install the ChillCheck software via a single setup script.

Step 1 — Wait for the Pi to boot

Allow 60–90 seconds for the first boot. The green LED on the Pi will flicker during boot and settle to an occasional flash when ready.

Step 2 — Connect to the Pi via SSH

From any computer on the same network:

Open PowerShell or Command Prompt and run:

ssh pi@chillcheck.local

If that does not work, try the Pi's IP address instead (check your router's connected device list).

Open Terminal and run:

ssh pi@chillcheck.local

Enter the password you set in Raspberry Pi Imager.

Can't connect?

If chillcheck.local does not resolve, mDNS may not be supported on your network. Check your router's DHCP table for a device named chillcheck and use its IP address directly.

Step 3 — Run the ChillCheck setup script

Once logged in, run:

curl -sSL https://raw.githubusercontent.com/Give-Us-A-Break/chillcheck/main/pi/setup.sh | sudo bash

This script:

  • Updates Raspberry Pi OS
  • Installs Mosquitto (MQTT broker), Zigbee2MQTT, Python 3, and all dependencies
  • Creates the chillcheck service user
  • Installs and enables the ChillCheck systemd services
  • Configures the local UI at port 80

The script takes 5–15 minutes depending on your internet connection. You will see progress output in the terminal.

Internet connection required

The Pi must have internet access to download packages. Connect via ethernet before running the script.

Step 4 — Verify services are running

Once the script completes, check that all services are active:

sudo systemctl status chillcheck-subscriber chillcheck-local-ui mosquitto zigbee2mqtt

All four should show active (running). If any show failed, see Troubleshooting.

Step 5 — Open the local hub UI

From any browser on the same network, go to:

http://chillcheck.local

You should see the ChillCheck hub interface showing "This Pi isn't linked yet."

Next step

Link your hub to your ChillCheck account →