Skip to main content

Update Online

APT Repository

RadxaOS is an operating system based on Debian / Ubuntu. Our system contains not only the APT repositories of the upstream system, but also additional repositories for RadxaOS-specific packages.

APT Repository Configuration Files

The APT repository configuration files are usually stored in two places:

  1. /etc/apt/sources.list: main repository
  2. /etc/apt/sources.list.d/*.list: additional repositories

The following are common additional repositories in RadxaOS:

$ ls /etc/apt/sources.list.d/
bookworm-backports.list bookworm-updates.list radxa.list
bookworm-security.list radxa-amlogic.list


These files provide some additional repositories upstream. Where bookworm is the operating system codename, which can be queried with the following command:

$ grep VERSION_CODENAME /etc/os-release


This file provides the main RadxaOS repository. This repository contains common packages developed by Radxa that are safe to use on most systems.


This file provides the RadxaOS Vendor repository. This repository contains private packages provided in the Vendor SDK.

Since most of these packages are created by third parties and cannot be guaranteed to comply with the Debian Policy, this repository is not installed by default on the CLI version to prevent the system from automatically parsing and installing the software in this repository, which may cause the system to fail to run normally.


If you need to use software from this repository, Radxa recommends using the desktop version of RadxaOS.

RadxaOS Vendor Repository


Enabling the RadxaOS Vendor repository on non-desktop variants of RadxaOS is unsupported, so please use with caution.

Please run the following command to add the RadxaOS Vendor repository:

VENDOR="$(tr $"\0" $"\n" < /proc/device-tree/compatible | tail -n 1 | cut -d "," -f 1)"
source /etc/os-release
echo "deb [signed-by=/usr/share/keyrings/radxa-archive-keyring.gpg]" \
sudo tee "/etc/apt/sources.list.d/radxa-$VENDOR.list"
sudo apt-get update

The Rockchip Vendor repository is only supported for Debian-based RadxaOS. packages contained in this repository will not work properly on Ubuntu.

Also, the Rockchip Vendor repository requires additional configuration to ensure that packages from this repository are prioritized for use on your system.

You can configure and install most of the Rockchip Vendor packages by doing the following after running the above commands:

sudo apt-get dist-upgrade --allow-downgrades task-rockchip
sudo apt-get dist-upgrade --allow-downgrades

RadxaOS Testing Repository


The software inside the testing repository is not verified, please use it with caution.

Please run the following command to use the RadxaOS test repository:

VENDOR="$(tr $"\0" $"\n" < /proc/device-tree/compatible | tail -n 1 | cut -d "," -f 1)"
source /etc/os-release
echo "deb [signed-by=/usr/share/keyrings/radxa-archive-keyring.gpg]" \
sudo tee "/etc/apt/sources.list.d/radxa.list"
echo "deb [signed-by=/usr/share/keyrings/radxa-archive-keyring.gpg]" \
sudo tee "/etc/apt/sources.list.d/radxa-$VENDOR.list"
sudo apt-get update

China Repository Mirror

Please run the following command to use the RadxaOS repository mirror provided by the third parties:


RadxaOS cannot guarantee the availability or download speed of third-party mirrors.

This mirror is provided by aghost.

sudo sed -i "s|||g" /etc/apt/sources.list.d/radxa*.list
sudo apt-get update