Linux Docker Environment Setup¶

Docker is supported on all Kickpi motherboards. The system does not come with Docker pre-installed by default, so you must install it according to your specific system version.

System	Pre-installed	Notes
Ubuntu 24.04	No	Manual installation of Docker CE required
Debian 12	No	Manual installation of Docker CE required
Debian 11	No	Manual installation of `docker.io` required

Ubuntu 24.04¶

1. Configure the firewall (iptables):

$ sudo apt install iptables
$ sudo update-alternatives --set iptables /usr/sbin/iptables-legacy
$ sudo update-alternatives --set ip6tables /usr/sbin/iptables-legacy

2. Verify that iptables is configured correctly:

$ iptables --version
iptables v1.8.10 (legacy)

3. Add the official Docker GPG key and APT repository:

$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
$ echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

For users in China, you can use the [Tsinghua TUNA][tuna_mirror] mirror:

$ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-ce.gpg
$ echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-ce.gpg] https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu $(lsb_release -sc) stable" | sudo tee /etc/apt/sources.list.d/docker.list

4. Update the package list:

$ sudo apt update

5. Install Docker:

$ sudo apt install docker-ce docker-ce-cli containerd.io

6. Create the Docker daemon configuration file:

$ sudo vim /etc/docker/daemon.json
{
  "iptables": false
}

7. Start the Docker service:

$ sudo systemctl start docker

If you encounter issues, debug using:

$ sudo dockerd --debug

8. Run a test to verify the installation:

$ sudo docker run hello-world
$ sudo docker run -it debian bash

Debian 12¶

1. Configure the firewall (iptables):

$ sudo apt install iptables
$ sudo update-alternatives --set iptables /usr/sbin/iptables-legacy
$ sudo update-alternatives --set ip6tables /usr/sbin/iptables-legacy

2. Verify that iptables is configured correctly:

$ iptables --version
iptables v1.8.10 (legacy)

3. Add the Docker GPG key and APT repository:

curl -sSL https://download.docker.com/linux/debian/gpg | gpg --dearmor > /usr/share/keyrings/docker-ce.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-ce.gpg] https://download.docker.com/linux/debian $(lsb_release -sc) stable" > /etc/apt/sources.list.d/docker.list

5. Update the package list:

$ sudo apt update

6. Install Docker:

$ sudo apt install docker-ce docker-ce-cli containerd.io

7. Create the Docker daemon configuration file:

$ sudo vim /etc/docker/daemon.json
{
  "iptables": false
}

8. Start the Docker service:

$ sudo systemctl start docker

If you encounter issues, debug using:

$ sudo dockerd --debug

9. Run a test to verify the installation:

$ sudo docker run hello-world
$ sudo docker run -it debian bash

Debian 11¶

Install Docker.io:

$ sudo apt update
$ sudo apt install docker.io

Configure the firewall:

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

Check the Docker service status and start it:

$ sudo systemctl status docker
$ sudo systemctl start docker

Run a test to verify the installation:

$ sudo docker run hello-world
$ docker run -it ubuntu bash