Build a PiRogue
The hardware you need
In addition to a computer and an Internet connection, you will need, at least, a Raspberry Pi (+ its power supply), a SD-card and an ethernet cable.
Pick a Raspberry Pi
First, you need a Raspberry Pi. We support the following versions of Raspberry Pi:
- Raspberry Pi 4 Model B - 2GB
- Raspberry Pi 4 Model B - 4GB
- Raspberry Pi 4 Model B - 8GB
If you want to buy a Raspberry Pi, visit the rpilocator website to check for availability.
Pick a micro SD-card
Second, you need a SD-card to run your PiRogue. The SD-card has to be large enough to store the operating system and all the data generated by the PiRogue itself. By default, it stores 5 days of network traffic history.
You may choose:
- a 32GB micro SD-card for regular use
- a 64GB micro SD-card if you plan doing long runs, analyzing the traffic of multiple devices simultaneously
Pick an ethernet cable
In order to connect the PiRogue to the Internet, you should have an ethernet cable connecting your PiRogue to your network. A simple cat. 5 ethernet cable will do the job.
Depending on your needs, you would want to add a hat to your PiRogue and protect everything with a case.
Install PiRogue OS
Get PiRogue OS
PiRogue OS is released on GitHub and can be found in the release section of the PiRogue OS repository. The OS is pre-configured so you just need to flash it on a micro SD-card. The image (the binary file to be flashed on the SD-card) is compressed. The file you have to download on your computer has a name following this schema
Set up your SD card
Before flashing the image, you have to unzip the image on your computer. It can be done either by right-clicking on the ZIP file and choosing Decompress or with command line using the unzip command. Once unzipped, you should have a new file named
<year>-<month>-<day>-PiRogueOS-lite.img. This file is the image file you will have to flash on a micro SD-card. Linux users used to use command line can then use the
dd command to flash their SD-card.
We advice you to download Balena Etcher and install it on your computer. Run Balena Etcher as administrator and follow the steps illustrated by the screenshots below.
Once the flashing is complete, unplug the SD-card from your computer.
Set up the PiRogue
If you have the hat for your PiRogue, it is the good time for you to plug it in and put everything into the case. Insert your freshly flashed micro SD-card into the PiRogue, plug the ethernet cable to the PiRogue. Remember, this cable connects your PiRogue directly (or through network switch) to your ISP router.
Fire it up!
First, check that the SD card is correctly inserted into the appropriate slot of your PiRogue and the ethernet cable is properly connected. Then, plug the power supply. Wait few minutes before trying to access your PiRogue.
After few minutes, we will be able to connect a wi-fi device and use the PiRogue’s dashboard.
First, connect a wi-fi device such as your smartphone to the PiRogue’s wi-fi network
PiRogue1 (default password:
superlongkey). Next, open the PiRogue’s dashboard by going at
http://<PiRogue IP address>:3000 with your Web browser or directly with this link:
It will take around 4 minutes before network flows start appearing in the dashboard. At the first start of your PiRogue the dashboard will look empty or broken. Don’t worry, connect a device to the PiRogue’s WiFi network, wait 5 minutes and refresh the dashboard by pressing
F5 key on your keyboard.