Docker Installation Guide for Ubuntu, Windows, and macOS
Step-by-step guide to install Docker on Ubuntu, Windows, and macOS, including user setup and verification.
π³ Docker Installation β Complete Setup Guide
π§ What is Docker?
Docker is a platform used to build, run, and manage containerized applications. It packages code, dependencies, and environment configurations into a single container image, ensuring consistent behavior across systems.
βοΈ Step 1: Install Docker on Ubuntu (Linux)
π§© 1. Update and Install Required Packages
sudo apt update
sudo apt install ca-certificates curl gnupg lsb-release -yπ§© 2. Add Dockerβs Official GPG Key
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpgπ§© 3. Set Up the Docker Repository
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/nullπ§© 4. Install Docker Engine, CLI, and Compose
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -yπ§© 5. Verify Docker Installation
sudo systemctl start docker
sudo systemctl enable docker
docker --versionβ Output example:
Docker version 27.0.0, build xxxxxxxπ§© 6. Run Docker Without sudo
By default, Docker requires sudo.
To fix this, add your user to the Docker group:
sudo usermod -aG docker $USER && newgrp dockerThen verify:
docker run hello-worldβ If it prints βHello from Docker!β, your setup works perfectly.
πͺ Step 2: Install Docker on Windows
π§© 1. Download Docker Desktop
Go to: π https://www.docker.com/products/docker-desktop
π§© 2. Install
- Run the installer (
Docker Desktop Installer.exe) - Enable WSL 2 and Hyper-V when prompted
- Complete installation and reboot if required
π§© 3. Verify
Open PowerShell or CMD:
docker --versionRun test container:
docker run hello-worldβ You should see the Docker welcome message.
π Step 3: Install Docker on macOS
π§© 1. Download Docker Desktop
Go to: π https://www.docker.com/products/docker-desktop
π§© 2. Install
- Download
.dmgfile - Drag Docker.app to Applications
- Launch Docker Desktop from Launchpad
π§© 3. Verify
Open Terminal:
docker --version
docker run hello-worldβ Output: Docker runs successfully on macOS.
π§° Step 4: Common Post-Installation Commands
docker ps # list running containers
docker images # list images
docker stop <id> # stop container
docker rm <id> # remove container
docker rmi <id> # remove image
docker system prune -a # clean up everything