Skip to content

Linux Docker Guide

Mattscreative edited this page Nov 20, 2025 · 2 revisions

🐳 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


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

Clone this wiki locally