Docker Setup
Note
Ensure that your system is running Kernel version 6.1 or later, as this version includes the necessary configurations for Docker support.
You can install the latest kernel packages from the Vicharak APT repository by running:
sudo apt update
sudo apt upgrade
Setting Up Docker on Axon
Docker is a containerization platform that allows you to run applications in isolated environments. Follow the steps below to install and configure Docker on your Axon device.
Installing Docker
To install Docker, follow the official installation guide:
- This guide will walk you through:
Adding the official Docker repository
Installing the required dependencies
After installation, verify Docker by checking the installed version:
docker --version
Starting the Docker Service
Once Docker is installed, start its service using:
sudo service docker start
To ensure Docker starts automatically on every system boot, enable it using:
sudo systemctl enable docker
Verifying the Docker Network Setup
To confirm that Docker is set up correctly, check the available network interfaces:
ip a
If Docker is running properly, you should see an interface named docker0 in the output. This interface is created by Docker to manage container networking.
Troubleshooting: Fixing Docker Daemon Connection Issues
If you encounter the following error while running Docker commands:
docker: Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?
It may indicate an issue with the iptables backend. Follow these steps to resolve it.
Checking the iptables Backend
Docker requires iptables for managing network rules. Some Linux distributions use nftables by default, which can cause networking issues. To check which backend is being used, run:
sudo update-alternatives --display iptables
If the output shows nft, it means nftables is in use, which may not be compatible with Docker.
Switching to iptables Legacy Mode
To resolve potential compatibility problems, switch iptables to legacy mode:
sudo update-alternatives --set iptables /usr/sbin/iptables-legacy
sudo update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy
Restarting Docker
After switching to iptables legacy mode, restart the Docker service to apply the changes:
sudo systemctl restart docker
Verifying the Fix
Once the Docker service restarts, check if it is running correctly:
sudo systemctl status docker
If Docker is now running, verify network connectivity by listing Docker networks:
docker network ls
You should see bridge, host, and none networks, confirming that Docker networking is functioning properly.
Summary
Install Docker using the official guide.
Start and enable the Docker service.
Verify installation by checking for the docker0 network interface.
If the Docker daemon is not running, check the iptables backend.
If nftables is in use, switch to iptables-legacy.
Restart Docker and verify that it runs correctly.
Following these steps ensures that Docker is fully functional on your system, preventing common network and service-related issues.