Installing on a Raspberry Pi

View as Markdown

The runZero Explorer runs discovery scans, and in most cases you can deploy it on an existing system with connectivity to the network you want to discover. Some locations, like retail stores or customer sites, may have no staff or hardware available to install one, which makes remote deployment tricky.

For those sites, install a runZero Explorer on a Raspberry Pi and send the device to the location for them to plug into their network.

What you’ll need

  • Raspberry Pi 4 Model B (4GB or 8GB), Raspberry Pi Compute Module 4, or Raspberry Pi 400
  • At least 1GB of free storage space on your Raspberry Pi’s MicroSD card after installing the operating system

Connecting to your Raspberry Pi via SSH

These steps show you how to SSH to your Raspberry Pi and install the Explorer from your terminal.

Step 1. Enable SSH on your Raspberry Pi

Enable SSH on the device before you try to connect.

You can add a file called ssh.txt at the root of the SD card and reboot the Raspberry Pi. The file can be empty. On reboot, the Pi enables SSH if the file is present.

Step 2. Update the password for your Raspberry Pi

With SSH enabled, you must update your credentials.

Log in as the pi user and run passwd to change the default password. The passwd command asks for your current password before it lets you set a new one.

Step 3. Copy the Explorer instructions

  • Go to your console and verify you’re in the right organization. runZero keys the Explorer download link to the organization you’re viewing, which associates the Explorer with that organization.

  • Go to the Explorer deployment page, select Linux Distributions, and choose Linux ARM 32-bit V7. Raspbian uses a 32-bit kernel by default, even on 64-bit Raspberry Pi hardware.

  • Click the instructions at the bottom of the Linux installation page to copy the commands to your clipboard.

Step 4. Install the Explorer

Some parts of the application still use the name "Rumble" for backwards compatibility. We'll update the documentation as they change.

Connect to the Raspberry Pi over SSH and paste the installation command into the terminal. The URL in the command ties the installation to your active organization, so yours will differ from the example below.

me@mac ~ % ssh pi@hostIP
pi@host's password:
pi@raspberrypi:~ $ sudo bash
root@raspberrypi:/home/pi# cd Downloads
root@raspberrypi:/home/pi# curl -o runzero-explorer.bin https://console.runzero.com/download/explorer/DT[uniqueToken]/[versionID]/runzero-explorer-linux-arm7.bin && chmod u+x runzero-explorer.bin && sudo ./runzero-explorer.bin

The Explorer installs itself in /opt/runzero and sets up a systemd service named runzero-agent-, which starts automatically on boot.

Next steps

Your Raspberry Pi is now a runZero Explorer box, ready to ship wherever you need it.

You can view and manage your registered Explorers from your console at any time, and Managing Explorers covers what you can do there.

Updated