Welcome to the IRLbox installation guide. These instructions will help you set up IRLbox on your compatible device.
Before you begin, ensure you have the following:
By downloading and using the IRLbox images, you are agreeing to participate in our beta testing program. Please be aware:
| Board Model | Beta Release | Dev Release | Version | Distro / Kernel | sha1 checksum |
|---|---|---|---|---|---|
| Orange Pi 5 Plus | "Switchable" From Dev → | Download | 0.0.26 | Ubuntu 24.04 / Kernel 6.1 | 4c41c31c2db58684156cd0127eb19a373de1ff50 |
| Orange Pi 5 | "Switchable" From Dev → | Download | 0.0.25 | Ubuntu 24.04 / Kernel 6.1 | 6117bcdb0fa025226b924ef60ba45a9a9c7e497d |
| Orange Pi 3B | "Switchable" From Dev → | Download | 0.0.25 | Ubuntu 24.04 / Kernel 6.1 | 015eaadba284a15d49a6b0c5a1a315747dbd3a03 |
| Orange Pi 5 Ultra | no eMMC (yet) → | Download | 0.0.7 | Ubuntu 22.04 / Kernel 6.1 | 4a91a0f207ea1009aaa0b39d3ce1a98847a4cebe |
| Radxa Zero 3W/E | "Switchable" From Dev → | Download | 0.0.28 | Ubuntu 24.04 / Kernel 6.1 | 586151f8f5f837db793c86ee778c4a8b4d9c73fa |
| Radxa Rock 5A | "Switchable" From Dev → | Download | 0.0.25 | Ubuntu 24.04 / Kernel 6.1 | d29e663fa5449ca958cfdd79a22470fce897f63e |
| Radxa Rock 5B+ | "Switchable" From Dev → | Download | 0.0.9 | Ubuntu 24.04 / Kernel 6.1 | 93205cd2505940fd4c3b23abfa524f2106c4ac36 |
Windows (Rufus / Balena Etcher):
macOS (Raspberry Pi Imager / Balena Etcher):
ADVANCED TECH SKILLY ONLY!
apt-get install bmap-tools gdisk
fdisk -l
bmaptool copy --nobmap [IMAGENAME].img /dev/sdX
⚠️ double check if you are really flashing the correct disk drive!! ⚠️You have been warned! ⚠️
after you wrote it to your sdcard you will have to "write the GPT" because the size changed.
gdisk /dev/sdX
simply type w to write the GPT and then you can use it
ADVANCED TECH SKILLY ONLY!
brew install python gdisk
curl -Lo bmaptool https://github.com/01org/bmap-tools/releases/download/v3.4/bmaptool
chmod +x bmaptool
diskutil list
diskutil unmountDisk /dev/diskX
./bmaptool copy --nobmap [IMAGENAME].img /dev/rdiskX
se the size changed.
gdisk /dev/rdiskX
simply type w to write the GPT and then you can use it
⚠️ double check if you are really flashing the correct disk drive!! ⚠️You have been warned! ⚠️
So this really requires you NOT to unmount via UI rdisk is the "real" disk drive
Connect your device to your router with an Ethernet cable.
Open a browser on a device in the same network and go to:
http://irlbox.local/http://irlbox/Once inside the IRLbox dashboard, you can adjust stream quality, encoder settings, storage, and more.
If you cannot access the dashboard:
We welcome your bug reports, suggestions, and experiences. Your input helps improve IRLbox for everyone.