Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

rsdk-build

Build RadxaOS system image.

Command usage

$ rsdk build [options] <product> [suite] [edition]

Options

--no-cache
    Do not use cached build artifacts. This will result in rootfs rebuild.
--no-efi
    Do not create EFI partition in the generated image.
-d | --debug
    Enable debug output. This will also build rootfs into a folder for easier
    examination.
-T | --test-repo
    Build using Radxa APT test archives.
-m | --mirror <mirror_url>
    Specify custom Debian / Ubuntu archive mirror URL.
-M <mirror_url>
    Specify custom non-Debian non-Ubuntu archive mirror URL. This mirror should
    serve both Radxa archives as well as any other 3rd party archives.

    The following archives will use this mirror:
        vscodium
        radxa
-i | --image-name <image_name>
    Set the system image name. (Default: output.img)
-h | --help
    Show this message.
-k | --override-kernel
    Override the default kernel profile. Ex: latest, rockchip, rk2312, etc.
-f | --override-firmware
    Override the default firmware profile. Ex: latest, rknext, etc.
-p | --override-product
    Override the default product profile. Ex: rock-4se, radxa-zero, etc
--no-vendor-packages
    Do not install the vendor package specified in product profile.
--debs <debs_dir>
    Include <debs_dir> as the local package archive.
    The packages in this archive will be preferred over all other archives.
    Packages will be kept even after the build is completed, effectively
    disabling any future upgrades on the included packages.
    WARNING: the entire content of <debs_dir> will be included!
--sdboot
    [EXPERIMENTAL] Enable systemd-boot.
    This feature is off by default, as U-Boot will try EFI boot first before
    Standard boot.
    Only supported in some distros.
-s | --sector-size <sector_size>
    Override image's sector size. Ex: 512 (default), 4096, etc.
    This is used when the local storage has a different sector size compared
    to the target storage.
    By default, rsdk assumes running on a 512-byte sector storage, building
    512B system image. This option can be used to create 4096B image that is
    needed for UFS boot.
    Building 512B image on non-512B storage is currently not supported.

Build RadxaOS image

When no suite or edition options is supplied, rsdk-build will use the product-specific default values, which are defined in src/share/rsdk/configs/products.json as the first element of the respective array.
Using ROCK 3C as an example, if you want to build a CLI image for RadxaOS Bullseye, you can run the following command:

rsdk build rock-3c bullseye cli

RadxaOS output path

you can find the generated RadxaOS image as out/${product}_${suite}_${edition}/output.img.