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.
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.