This option uses a Raspberry Pi as a DIY NetBeez hardware monitoring agent. It’s ideal if you want to deploy your own low-cost wired or Wi-Fi sensor that can gather wireless metrics such as Wi-Fi signal strength, link quality, and connection timing.
Prerequisites
A valid NetBeez dashboard with a secret key
Raspberry Pi 4 (or earlier) OR Raspberry Pi 5
16 GB micro SD card
Our pre-built DIY image:
Raspberry Pi 4 or earlier: Download the DIY Image for RPi 4
Raspberry Pi 5: Download the DIY Image for RPi 5
Optional: External Wi-Fi dongle if using Wi-Fi 6/6E
A way to flash the DIY image to the SD card (e.g., BalenaEtcher).
Step 1 — Download the Pi Image
Download the NetBeez Raspberry Pi DIY image.
Flash the image to your micro-SD card using your preferred imaging tool.
Step 2 — Boot and Configure the Raspberry Pi
Insert the micro-SD card into the Raspberry Pi and power it on.
Log in as user netbeez (password: netbeez) and immediately change the password:
passwd
Step 3 — Connect the Pi to Your NetBeez Dashboard
Open the NetBeez dashboard, go to Settings → About, and copy your installation command (which includes your secret key).
On the Raspberry Pi, run the agent setup script that includes your secret key. For example:
curl -L -O https://raw.githubusercontent.com/netbeez/agent-installation/master/agent_setup.sh sudo bash agent_setup.sh --secret=<your_secret_key>
During setup the script will ask whether to leave the onboard Wi-Fi enabled or disabled. Answer based on your desired configuration (e.g. if you are looking to set up a wired sensor or to use use an external Wi-Fi dongle disable the onboard Wi-Fi module to avoid conflicts).
Verifying Installation
After a successful setup, the new Raspberry Pi sensor should appear in your NetBeez dashboard as a hardware monitoring agent. From there you can schedule tests and monitor performance just like any other NetBeez agent.