Build your first image
Migration notice
After more than 2 years of development, we have grown beyond what rbuild
's underlying dependencies are capable of.
We have switched to a lower-level tool and completely restructured the project.
Please use rsdk
for the new project, which is meant to be compatible with
existing rbuild
systems. rbuild
is now in maintenance mode.
Install dependencies
Currently, due to our dependency on debos
, we can only run rbuild
on x86 based system. If you are building in a virtual machine, you need to enable nested virtualization, as KVM is required for building the image.
Debian 12 / Ubuntu 22.04
sudo apt update
sudo apt install -y git
# Podman (recommended)
sudo apt install -y podman podman-docker
sudo touch /etc/containers/nodocker
# Docker
#sudo apt install -y docker.io
#sudo adduser $USER docker
#sudo reboot
Check out the code
git clone https://github.com/radxa-repo/rbuild.git
Build your first image
Once the repo is cloned on your machine, you can run rbuild
without any arguments to check the help message:
cd rbuild
./rbuild
Most options listed in the help messages are targetting at developers. If you only want to build an image locally, you can run rbuild
with only the required arguments:
# Build radxa-cm3-sodimm-io image with default OS (currently Debian Bullseye) and flavor (CLI)
./rbuild radxa-cm3-sodimm-io
# Build rock-5b Debian image with KDE
./rbuild rock-5b kde
Supported products, suites, and flavors are listed at the end of the help message.
Radxa supports and recommends Debian on all Radxa products.
Building Ubuntu requires special instruction.