IOT-GATE-RPI5: Raspberry Pi OS image installation
Contents
Overview
This article describes how to install the IOT-GATE-RPI5 Raspberry Pi OS image onto the internal storage of the Compulab IOT-GATE-RPI5. The recommended installation procedure uses a host PC running a Debian-based operating system and follows Raspberry Pi recommendations to use the Raspberry Pi Imager tool (AppImage) as the preferred installation method.
Preparing the host PC
To prepare the host PC for installing the IOT-GATE-RPI5 Raspberry Pi OS image, perform the following steps:
- Obtain a Debian-based workstation with an available USB port
- Obtain the IOT-GATE-RPI5 Raspberry Pi OS image:
- Download IOT-GATE-RPI5 Raspberry OS image archive
- Extract the image from the ZIP archive
- Obtain the Raspberry Pi Imager tool (AppImage):
- Download the latest version of an AppImage from the Raspberry Pi website
- Make it executable
- Run with root root privileges
- Install the following additional packages:
build-essential libusb-1.0-0-dev pkg-config git
- Obtain the Raspberry Pi USB boot tool (rpiboot):
- Clone the git repository
- Build and run the rpiboot tool
- The tool will wait for the connection.
Example
# Prepare working directories
mkdir -p ~/work/iot-gate-rpi5/{downloads,images,tools}
cd ~/work/iot-gate-rpi5/
# Download the IOT-GATE-RPI5 Raspberry OS image archive
wget -P ./downloads/ https://www.compulab.com/wp-content/uploads/2026/06/iot-gate-rpi5_raspios-linux_2026-06-09.zip
...
# Extract the archive
unzip -p ./images/ downloads/iot-gate-rpi5_raspios-linux_2026-06-09.zip
...
# Download the latest AppImage
wget -P ./tools/ https://downloads.raspberrypi.com/imager/imager_latest_amd64.AppImage
# Make it executable
chmod a+x ./tools/imager_latest_amd64.AppImage
# Run as root:
sudo ~/work/iot-gate-rpi5/tools/imager_latest_amd64.AppImage
...
# Install required packages
sudo apt-get install build-essential libusb-1.0-0-dev pkg-config git
...
# Clone git repository with rpiboot sources
git clone --depth=1 https://github.com/raspberrypi/usbboot ./tools/usbboot
...
# Build the rpiboot utility
make -C ./tool/usbboot/
...
# Run the tool:
cd ./tool/usbboot/ ; sudo ./rpiboot
Preparing the IOT-GATE-RPI5
The USB programming port is located behind the Service bay door on the Side panel.
- Remove the Service bay door to access the USB programming port.
- Connect the IOT-GATE-RPI5 micro-USB connector with the workstation USB port using a standard micro-USB cable.
- Power on the IOT-GATE-RPI5. The rpiboot tool will discover the IOT-GATE-RPI5 and send boot code to allow access to its internal storage (eMMC).
Flashing IOT-GATE-RPI5 Raspberry Pi OS image into the device storage (eMMC)
Flashing image using Raspberry Pi Imager
- Once rpiboot completes, a new block device, /dev/sdX (where X is the lowercase letter identifying the drive), will appear.
- Switch to the Raspberry Pi Imager application, which should already be running with root privileges.
- In the Device section, select the Raspberry Pi 5 option and press the
NEXTbutton. - In the OS section, select the Use custom option, navigate to the directory containing the IOT-GATE-RPI5 OS image, select the image, and press the
NEXTbutton. - In the Storage section, select mmcblk0 Raspberry Pi multi-function USB device and press the
NEXTbutton. - In the Writing section, press the
WRITEbutton. When prompted with the warning screen, confirm by pressingI UNDERSTAND, ERASE AND WRITE.
- The AppImage will begin writing the image to the storage device. This process may take several minutes.
- After writing the image, the imager verifies that it has been written correctly. This step may also take several minutes. If you wish to skip verification, press
SKIP VERIFICATIONbutton.
- In the Done section press
FINISHbutton to exit AppImage
Flashing the Image Using Command-Line Utilities
| It is also possible to install the IOT-GATE-RPI5 Raspberry Pi OS image onto the device storage using common command-line utilities. |
- Once rpiboot completes, a new block device, /dev/sdX (where X is the lowercase letter identifying the drive), will appear.
- Unmount any partitions that may have been mounted automatically:
sudo umount /dev/sdX*
- Flash the OS image to the device storage:
unzip -p ~/work/iot-gate-rpi5/downloads/iot-gate-rpi5_raspios-linux_2026-06-09.zip | sudo dd of=/dev/sdX bs=1M status=progress conv=fsync ; sync ; sudo eject /dev/sdX
| The image may be installed in the same way on any block storage device, including removable USB media. |
Booting IOT-GATE-RPI5 after installation
- Power-off IOT-GATE-RPI5.
- Unplug the USB cable from the USB programming port.
- Power-on IOT-GATE-RPI5.
Flashing the standard Raspberry Pi OS image
Please refer to the Raspberry Pi OS documentation for detailed instructions on flashing a standard Raspberry Pi OS image.