Official reference documentation: https://docs.docker.com/engine/install/debian/

Description

You need to first flash the Debian12 system image onto the LCSC-TaishanPi-3M-RK3576 development board, then follow the steps below to install Docker.

Note: Before proceeding, please ensure that the LCSC-TaishanPi-3M-RK3576 network is connected!

Required Settings

If you are using images dated before 2026-03-06, before installing Docker, you need to run two commands on the LCSC-TaishanPi-3M system:

sudo update-alternatives --set iptables /usr/sbin/iptables-legacy
sudo update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy

These two commands set the system's iptables and ip6tables to legacy mode to ensure that Docker can run properly.

Image Installation

Special Note

When installing Docker in China, you may encounter network issues that cause installation failure. To avoid this situation, some mirror websites have emerged in China. These mirror websites generally provide Docker installation scripts with domestic mirror sources configured in the scripts, which can avoid installation failures due to network issues.

Run the following script:

# Method 1: Install Docker with Aliyun mirror source:
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

# Method 2: Install Docker with AzureChinaCloud mirror source:
curl -fsSL https://get.docker.com | bash -s docker --mirror AzureChinaCloud

If it still doesn't work, you can use the Xuanyuan Mirror one-click installation script

bash <(curl -fsSL https://xuanyuan.cloud/docker.sh)

After installation, you can verify that Docker is installed successfully by running the docker --version command:

lckfb@TaishanPi-3M:~$ docker --version
Docker version 29.2.1, build a5c7197

Subsequently, you need to add docker image sources on your own, so that when pulling images, you can use domestic mirror sources to speed up downloads.