Linux Docker Guide

Linux Docker Guide

Complete beginner-friendly guide to Docker on Linux, covering Arch Linux, CachyOS, and other distributions including installation, container management, and Docker Compose.

---

Table of Contents

1. Docker Installation
2. Docker Basics
3. Container Management
4. Docker Images
5. Docker Compose
6. Troubleshooting

---

Docker Installation

Install Docker

Arch/CachyOS:

# Install Docker
sudo pacman -S docker docker-compose

# Enable service
sudo systemctl enable --now docker

# Add user to docker group
sudo usermod -aG docker $USER

Debian/Ubuntu:

sudo apt install docker.io docker-compose
sudo systemctl enable docker

Fedora:

sudo dnf install docker docker-compose
sudo systemctl enable docker

Verify Installation

Check Docker:

# Check version
docker --version

# Test Docker
docker run hello-world

---

Docker Basics

Run Container

Basic usage:

# Run container
docker run nginx

# Run in background
docker run -d nginx

# Run with name
docker run --name my-nginx nginx

Container Management

Manage containers:

# List containers
docker ps
docker ps -a

# Stop container
docker stop container-name

# Start container
docker start container-name

# Remove container
docker rm container-name

---

Container Management

Execute Commands

Run commands in container:

# Execute command
docker exec -it container-name /bin/bash

# Run command
docker exec container-name command

View Logs

Container logs:

# View logs
docker logs container-name

# Follow logs
docker logs -f container-name

---

Docker Images

Pull Images

Download images:

# Pull image
docker pull nginx

# List images
docker images

# Remove image
docker rmi image-name

Build Images

Create image:

# Build from Dockerfile
docker build -t my-image .

# Tag image
docker tag my-image:latest my-image:v1.0

---

Docker Compose

Docker Compose

Use Compose:

# Start services
docker-compose up -d

# Stop services
docker-compose down

# View logs
docker-compose logs

Compose File

docker-compose.yml:

version: '3'
services:
  web:
    image: nginx
    ports:
      - "80:80"
  db:
    image: postgres
    environment:
      POSTGRES_PASSWORD: password

---

Troubleshooting

Docker Not Starting

Check service:

# Check status
systemctl status docker

# Start Docker
sudo systemctl start docker

# Check logs
journalctl -u docker

Permission Errors

Fix permissions:

# Add user to docker group
sudo usermod -aG docker $USER

# Log out and back in

---

Summary

This guide covered Docker installation, container management, and Docker Compose for Arch Linux, CachyOS, and other distributions.

---

Next Steps

• Virtualization - Virtualization
• Container Orchestration - Orchestration
• Docker: https://www.docker.com/

---

This guide covers Arch Linux, CachyOS, and other Linux distributions. For distribution-specific details, refer to your distribution's documentation.