Use apt for package management

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

Confirm the System Codename

Before modifying the repository configuration, confirm the system codename (VERSION_CODENAME) by running the following command:

grep VERSION_CODENAME /etc/os-release

Example output:

VERSION_CODENAME=bookworm

Choose the appropriate repository source based on the codename.

bookworm-*.list

These files provide some additional repositories upstream. Where bookworm is the operating system codename.

radxa.list

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

radxa-*.list

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.

tip

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

RadxaOS Vendor Repository

Enable

warning

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]" \
     "https://radxa-repo.github.io/$VERSION_CODENAME $VENDOR-$VERSION_CODENAME main" | \
     sudo tee "/etc/apt/sources.list.d/radxa-$VENDOR.list"
sudo apt-get update

note

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

Disable

To disable this repository, simply delete the corresponding configuration file:

VENDOR="$(tr $"\0" $"\n" < /proc/device-tree/compatible | tail -n 1 | cut -d "," -f 1)"
sudo rm "/etc/apt/sources.list.d/radxa-$VENDOR.list"
sudo apt-get update

note

Deleting the Vendor repository does not remove installed packages. However, these packages will not be updated again and may be overwritten by packages in other repositories.

To ensure proper operation of your operating system, do not change your system's default repository configuration.

RadxaOS Testing Repository

Enable

warning

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]" \
     "https://radxa-repo.github.io/$VERSION_CODENAME-test $VERSION_CODENAME-test main" | \
     sudo tee "/etc/apt/sources.list.d/radxa.list"
echo "deb [signed-by=/usr/share/keyrings/radxa-archive-keyring.gpg]" \
     "https://radxa-repo.github.io/$VERSION_CODENAME-test $VENDOR-$VERSION_CODENAME-test main" | \
     sudo tee "/etc/apt/sources.list.d/radxa-$VENDOR.list"
sudo apt-get update

Disable

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]" \
     "https://radxa-repo.github.io/$VERSION_CODENAME $VERSION_CODENAME main" | \
     sudo tee "/etc/apt/sources.list.d/radxa.list"
echo "deb [signed-by=/usr/share/keyrings/radxa-archive-keyring.gpg]" \
     "https://radxa-repo.github.io/$VERSION_CODENAME $VENDOR-$VERSION_CODENAME main" | \
     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:

note

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

aghost

This mirror is provided by aghost.

sudo sed -i "s|https://radxa-repo.github.io|https://mirrors.aghost.cn/radxa-deb|g" /etc/apt/sources.list.d/radxa*.list
sudo apt-get update

cqu

This mirror is provided by Chongqing University Open Source Software Mirror Station.

sudo sed -i "s|https://radxa-repo.github.io|https://mirrors.cqu.edu.cn/radxa-deb|g" /etc/apt/sources.list.d/*radxa*.list
sudo apt-get update

LZUOSS

This mirror is provided by LZUOSS.

sudo sed -i "s|https://radxa-repo.github.io|https://mirrors.lzu.edu.cn/radxa-deb|g" /etc/apt/sources.list.d/*radxa*.list
sudo apt-get update

HUST

This mirror is provided by HUST.

sudo sed -i "s|https://radxa-repo.github.io|https://mirrors.hust.edu.cn/radxa-deb|g" /etc/apt/sources.list.d/*radxa*.list
sudo apt-get update

SDU

This mirror is provided by SDU.

sudo sed -i "s|https://radxa-repo.github.io|https://mirrors.sdu.edu.cn/radxa-deb|g" /etc/apt/sources.list.d/*radxa*.list
sudo apt-get update

NJU

This mirror is provided by NJU.

sudo sed -i "s|https://radxa-repo.github.io|https://mirror.nju.edu.cn/radxa-deb|g" /etc/apt/sources.list.d/*radxa*.list
sudo apt-get update

NYIST

This mirror is provided by NYIST.

sudo sed -i "s|https://radxa-repo.github.io|https://mirror.nyist.edu.cn/radxa-deb|g" /etc/apt/sources.list.d/*radxa*.list
sudo apt-get update

Restore Defaults

sudo sed -e "s|https://mirrors.aghost.cn/radxa-deb|https://radxa-repo.github.io|g" \
         -e "s|https://mirrors.cqu.edu.cn/radxa-deb|https://radxa-repo.github.io|g" \
         -e "s|https://mirrors.lzu.edu.cn/radxa-deb|https://radxa-repo.github.io|g" \
         -e "s|https://mirrors.hust.edu.cn/radxa-deb|https://radxa-repo.github.io|g" \
         -e "s|https://mirrors.sdu.edu.cn/radxa-deb|https://radxa-repo.github.io|g" \
         -e "s|https://mirror.nju.edu.cn/radxa-deb|https://radxa-repo.github.io|g" \
         -e "s|https://mirror.nyist.edu.cn/radxa-deb|https://radxa-repo.github.io|g" \
         -i /etc/apt/sources.list.d/*radxa*.list
sudo apt-get update

Please run the following command to use the Debian / Ubuntu repository mirror provided by third parties:

note

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

ustc

This mirror is provided by the University of Science and Technology of China Open Source Software Mirror Station.

sudo sed -i 's/deb.debian.org/mirrors.ustc.edu.cn/g' /etc/apt/sources.list.d/*
sudo sed -i 's/deb.ubuntu.com/mirrors.ustc.edu.cn/g' /etc/apt/sources.list.d/*
sudo apt-get update

tuna

This mirror is provided by Tsinghua University Open Source Software Mirror Station.

sudo sed -i 's/deb.debian.org/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list.d/*
sudo sed -i 's/deb.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list.d/*
sudo apt-get update

cqu

This mirror is provided by Chongqing University Open Source Software Mirror Station.

sudo sed -i 's/deb.debian.org/mirrors.cqu.edu.cn/g' /etc/apt/sources.list.d/*
sudo sed -i 's/deb.ubuntu.com/mirrors.cqu.edu.cn/g' /etc/apt/sources.list.d/*
sudo apt-get update

Restore Defaults

sudo sed -i 's/mirrors.ustc.edu.cn/deb.debian.org/g' /etc/apt/sources.list.d/*
sudo sed -i 's/mirrors.ustc.edu.cn/deb.ubuntu.com/g' /etc/apt/sources.list.d/*
sudo sed -i 's/mirrors.tuna.tsinghua.edu.cn/deb.debian.org/g' /etc/apt/sources.list.d/*
sudo sed -i 's/mirrors.tuna.tsinghua.edu.cn/deb.ubuntu.com/g' /etc/apt/sources.list.d/*
sudo sed -i 's/mirrors.cqu.edu.cn/deb.debian.org/g' /etc/apt/sources.list.d/*
sudo sed -i 's/mirrors.cqu.edu.cn/deb.ubuntu.com/g' /etc/apt/sources.list.d/*
sudo apt-get update

More mirrors can be found at Debian Mirror List and Ubuntu Mirror List.