Instalación de Docker y Docker Compose en Ubuntu 22.04 LTS

Esta guía documenta la instalación y configuración de Docker y Docker Compose en un servidor Ubuntu 22.04 LTS. El objetivo es crear una base sólida para desplegar proyectos PHP, WordPress, Node.js, React o APIs con contenedores.

Objetivo del entorno

Instalar Docker y Compose correctamente en Ubuntu, asegurando compatibilidad con HestiaCP, sin conflictos de puertos y con soporte para contenedores persistentes y automatización futura (CI/CD, Portainer, Dokploy, etc.).

Componentes y tecnologías

Docker Engine — motor principal que gestiona los contenedores.
Containerd — daemon interno que se encarga de la ejecución y ciclo de vida de cada contenedor.
Docker CLI — herramienta en línea de comandos para interactuar con el demonio Docker.
Docker Compose — permite definir aplicaciones multi-contenedor con un solo archivo docker-compose.yml.
Ubuntu 22.04 LTS — entorno base estable y compatible con la última versión de Docker.

Instalación paso a paso

# 1️⃣ Actualizar el sistema
apt update && apt upgrade -y

# 2️⃣ Instalar dependencias necesarias
apt install ca-certificates curl gnupg lsb-release -y

# 3️⃣ Agregar la clave GPG oficial de Docker
mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 4️⃣ Agregar el repositorio oficial de Docker
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
  https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" \
  | tee /etc/apt/sources.list.d/docker.list > /dev/null

# 5️⃣ Instalar Docker Engine y plugins
apt update
apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

# 6️⃣ Habilitar e iniciar el servicio Docker
systemctl enable docker
systemctl start docker

# 7️⃣ Verificar instalación
docker --version
docker compose version

📘 Explicación detallada

apt update / upgrade: sincroniza la lista de paquetes y actualiza los existentes.
ca-certificates: habilita la verificación SSL/TLS para conexiones seguras.
curl: se usa para descargar scripts y claves remotas.
gnupg: gestiona la autenticidad de los repositorios con firmas GPG.
lsb-release: permite a Docker detectar la versión exacta de Ubuntu.
keyrings: carpeta que almacena las claves oficiales del repositorio Docker.
docker-ce: instala la versión estable (Community Edition) del motor Docker.
docker-compose-plugin: agrega el comando docker compose nativo, sin necesidad del binario clásico.

Instalar binario clásico de Docker Compose (opcional)

# Descargar e instalar manualmente el binario docker-compose
curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" \
  -o /usr/local/bin/docker-compose

# Darle permisos de ejecución
chmod +x /usr/local/bin/docker-compose

# Verificar versión
docker-compose --version

Esta versión clásica se mantiene por compatibilidad con proyectos o scripts que aún no usan el nuevo formato docker compose (sin guion). Ambas versiones pueden coexistir sin interferir entre sí.

Verificación de instalación

# Comprobar el estado del servicio Docker
systemctl status docker

# Probar ejecución con un contenedor de prueba
docker run hello-world

Si el mensaje “Hello from Docker!” aparece correctamente, significa que el demonio Docker está operativo y puede descargar y ejecutar imágenes desde Docker Hub. Este contenedor se elimina automáticamente después de la prueba.

Resultados y entorno final

Docker Engine y Compose instalados correctamente.
Servicio Docker configurado para iniciarse automáticamente con el sistema.
Listo para desplegar contenedores y stacks con docker compose up -d.
Compatible con futuras herramientas de gestión como Portainer o Dokploy.

Regresar