This guide describes how to use debos-radxa, based on debos, to generate Debian/Ubuntu image for Radxa boards.

Please note that the release are auto generated builds without additional testing, if you have issues with the images, please submit an issue.

• Radxa CM3 IO
• Radxa E23
• Radxa E25
• Radxa NX5
• Radxa Zero
• Radxa Zero 2
• ROCK 3A
• ROCK 3B
• ROCK 3C
• ROCK 5A
• ROCK 5B
• ROCK 4B
• ROCK 4C+

Auto generated build images: https://github.com/radxa/debos-radxa/releases/latest

You must install essential host packages on your build host.

The following command installs the host packages on an Ubuntu distribution.

$ sudo apt-get install -y git

The following command installs the host packages on an Debian distribution.

$ sudo apt-get install -y git user-mode-linux libslirp-helper

See Docker Docs installing Docker Engine on Ubuntu.

radxa@x86-64:~$ cd ~
radxa@x86-64:~$ git clone https://github.com/radxa/debos-radxa.git

radxa@x86-64:~$ cd ~/debos-radxa/
radxa@x86-64:~/debos-radxa$ docker run --rm --interactive --tty --tmpfs /dev/shm:rw,nosuid,nodev,exec,size=4g --user $(id -u) --security-opt label=disable \
--workdir $PWD --mount "type=bind,source=$PWD,destination=$PWD" --entrypoint ./build-os.sh godebos/debos
TOP DIR = /build/stephen/debos-radxa
====USAGE: ./build-os.sh -b  -m  -v ====
Board list:
    radxa-cm3-io
    radxa-e23
    radxa-e25
    radxa-nx5
    radxa-zero
    radxa-zero2
    rockpi-4b
    rock-4c-plus
    rock-3a
    rock-3b
    rock-3c
    rock-5a
    rock-5b

Model list:
    debian
    ubuntu

Variant list:
    xfce4
    server

radxa@x86-64:~$ cd ~/debos-radxa/
radxa@x86-64:~/debos-radxa$
radxa@x86-64:~/debos-radxa$ docker run --rm --interactive --tty --tmpfs /dev/shm:rw,nosuid,nodev,exec,size=4g --user $(id -u) --security-opt label=disable \
--workdir $PWD --mount "type=bind,source=$PWD,destination=$PWD" --entrypoint ./build-os.sh godebos/debos -b rock-5b -m debian -v xfce4

radxa@x86-64:~$ cd ~/debos-radxa/
radxa@x86-64:~/debos-radxa$
radxa@x86-64:~/debos-radxa$ docker run --rm --interactive --tty --tmpfs /dev/shm:rw,nosuid,nodev,exec,size=4g --user $(id -u) --security-opt label=disable \
--workdir $PWD --mount "type=bind,source=$PWD,destination=$PWD" --entrypoint ./build-os.sh godebos/debos -b rock-3a -m ubuntu -v server

The generated system images will be copied to ./output direcotry.

Launch dev-shell to get a shell inside debos docker. You can then run build-os.sh to monitor the build status. debos mounts root partition at /scratch/mnt, and boot partition is mounted at /scratch/mnt/boot. You can also chroot /scratch/mnt to examine the file system.

Currently dev-shell uses a custom docker image to build, so your result might be different from GitHub build. If you want to reproduce GitHub build please use the command from Usage section.

./configs/boards are board-specific debos recipes.

./rootfs/packages contains additional packages.

• Default non-root user: rock (password: rock)
• Automatically load Bluetooth firmware after startup
• The first boot will resize root filesystem to use all available disk space
• SSH installed by default
• Hostname: board_name