How to Install Docker in Linux

Installing Docker on your Linux system is a great way to start working with containers. Whether you're a developer, system administrator, or just curious, Docker helps you package applications and their dependencies in a neat, portable way. If you want to run Docker on Linux, I’ll guide you through the process step-by-step.

You don’t need to be an expert to get Docker up and running. This article will walk you through the installation on popular Linux distributions like Ubuntu, Debian, CentOS, and Fedora. By the end, you’ll have Docker installed and ready to use for your projects.

What is Docker and Why Use It on Linux?

Docker is a platform that lets you create, deploy, and run applications inside containers. Containers are lightweight, isolated environments that share the host system’s kernel but keep your app and its dependencies separate. This makes your apps portable and consistent across different systems.

Linux is the natural home for Docker because Docker uses Linux kernel features like cgroups and namespaces. Running Docker on Linux is efficient and fast. Here’s why you might want Docker on your Linux machine:

• Simplifies application deployment: Package your app with everything it needs.
• Improves resource usage: Containers use fewer resources than virtual machines.
• Enhances development workflow: Easily test and deploy apps in consistent environments.
• Supports microservices: Run multiple small services independently.

Now, let’s see how to install Docker on your Linux system.

Preparing Your Linux System for Docker Installation

Before installing Docker, you should prepare your Linux system to avoid common issues. Here’s what you need to do:

• Update your package index: This ensures you get the latest software versions.
• Remove old Docker versions: If you have older Docker packages, uninstall them to prevent conflicts.
• Install required packages: Some packages like apt-transport-https, ca-certificates, and curl are needed to add Docker’s repository securely.

For example, on Ubuntu or Debian, you can run:

sudo apt update
sudo apt remove docker docker-engine docker.io containerd runc
sudo apt install apt-transport-https ca-certificates curl software-properties-common

This prepares your system for the official Docker installation.

Installing Docker on Ubuntu and Debian

Ubuntu and Debian are among the most popular Linux distributions, and Docker supports them well. Here’s how you install Docker on these systems:

Step 1: Add Docker’s Official GPG Key

Docker signs its packages with a GPG key to ensure authenticity. Add this key to your system:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

Step 2: Add Docker Repository

Add Docker’s stable repository to your system’s package sources:

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

Step 3: Update Package Index and Install Docker

Update your package list and install Docker Engine:

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

Step 4: Verify Docker Installation

Check if Docker is installed and running:

sudo systemctl status docker

You should see Docker active and running. You can also test Docker by running:

sudo docker run hello-world

This command downloads a test image and runs it in a container, confirming your Docker setup works.

Installing Docker on CentOS and Fedora

For CentOS and Fedora, the installation steps differ slightly but remain straightforward.

Step 1: Remove Old Versions

Remove any older Docker packages:

sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine

Step 2: Set Up the Docker Repository

Install required packages and add Docker’s repository:

sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

Step 3: Install Docker Engine

Install Docker with:

sudo yum install docker-ce docker-ce-cli containerd.io

Step 4: Start and Enable Docker

Start Docker and enable it to launch on boot:

sudo systemctl start docker
sudo systemctl enable docker

Step 5: Verify Installation

Run the hello-world container to test:

sudo docker run hello-world

If you see a welcome message, Docker is installed correctly.

Post-Installation Steps: Running Docker Without sudo

By default, Docker commands require root privileges. To avoid typing sudo every time, you can add your user to the Docker group.

How to Add Your User to the Docker Group

Run this command:

sudo usermod -aG docker $USER

After this, log out and log back in or reboot your system. Now, you can run Docker commands without sudo.

Verify Group Addition

Test by running:

docker run hello-world

If it works without sudo, you’re all set.

Troubleshooting Common Docker Installation Issues

Sometimes, you might face issues during or after installation. Here are some common problems and how to fix them:

• Docker service not starting: Check status with sudo systemctl status docker. Restart with sudo systemctl restart docker.
• Permission denied errors: Make sure your user is added to the Docker group and you’ve logged out and back in.
• Old Docker versions conflicting: Remove old Docker packages completely before installing the new version.
• Firewall blocking Docker: Ensure your firewall allows Docker’s network traffic, especially if you use Docker Swarm or Kubernetes.

If problems persist, check Docker’s official documentation or community forums for help.

Updating Docker on Linux

Keeping Docker updated is important for security and new features. Here’s how to update Docker on your Linux system:

• Ubuntu/Debian:

sudo apt update
sudo apt upgrade docker-ce docker-ce-cli containerd.io

• CentOS/Fedora:

sudo yum update docker-ce docker-ce-cli containerd.io

After updating, restart Docker:

sudo systemctl restart docker

Regular updates ensure your Docker installation stays secure and stable.

Uninstalling Docker from Linux

If you ever need to remove Docker, follow these steps:

• Ubuntu/Debian:

sudo apt purge docker-ce docker-ce-cli containerd.io
sudo rm -rf /var/lib/docker

• CentOS/Fedora:

sudo yum remove docker-ce docker-ce-cli containerd.io
sudo rm -rf /var/lib/docker

Removing /var/lib/docker deletes all images, containers, and volumes, so back up anything important first.

Useful Docker Commands After Installation

Once Docker is installed, here are some commands you’ll use often:

• docker run [image]: Run a container from an image.
• docker ps: List running containers.
• docker ps -a: List all containers.
• docker images: List downloaded images.
• docker stop [container_id]: Stop a running container.
• docker rm [container_id]: Remove a container.
• docker rmi [image_id]: Remove an image.

Learning these commands helps you manage Docker efficiently.

Conclusion

Installing Docker on Linux is a straightforward process that opens up many possibilities for app development and deployment. Whether you use Ubuntu, Debian, CentOS, or Fedora, following the right steps ensures a smooth setup.

After installation, you can start exploring Docker’s powerful features like containerization, image management, and orchestration. Remember to keep Docker updated and manage permissions properly for the best experience. With Docker on your Linux system, you’re ready to build and run applications in a modern, flexible way.

FAQs

How do I check if Docker is installed correctly on Linux?

Run docker run hello-world. If you see a welcome message, Docker is installed and working properly.

Can I install Docker without root access?

You need root or sudo privileges to install Docker. However, after installation, you can run Docker commands without sudo by adding your user to the Docker group.

What Linux distributions support Docker?

Docker supports most major Linux distributions, including Ubuntu, Debian, CentOS, Fedora, and more.

How do I update Docker on my Linux system?

Use your package manager to update Docker. For example, on Ubuntu, run sudo apt update and sudo apt upgrade docker-ce.

How do I uninstall Docker completely from Linux?

Remove Docker packages with your package manager and delete Docker data with sudo rm -rf /var/lib/docker. This removes Docker and all containers and images.