Cómo instalar Docker en Ubuntu paso a paso (Guía Definitiva)

Docker se ha convertido en una herramienta imprescindible para desarrolladores y administradores de sistemas. Nos permite empaquetar aplicaciones con todas sus dependencias en contenedores ligeros, garantizando que funcionen en cualquier entorno.

Si estás usando Ubuntu y quieres instalar la versión más reciente, estable y segura de Docker Engine, estás en el lugar correcto. En esta guía te enseñaremos el método oficial paso a paso.

Paso 1: Eliminar versiones antiguas de Docker

Antes de comenzar, es fundamental limpiar tu sistema. Las versiones antiguas de Docker instaladas desde los repositorios genéricos de Ubuntu pueden causar conflictos.

Ejecuta el siguiente comando en tu terminal para desinstalarlas:

for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove \$pkg; done

Paso 2: Configurar el repositorio oficial

La forma recomendada de instalar Docker es utilizando su repositorio oficial. Esto te asegura recibir las actualizaciones de seguridad más recientes de forma automática.

Primero, actualiza la lista de paquetes de tu sistema e instala las herramientas necesarias para manejar conexiones seguras HTTPS:

sudo apt update
sudo apt install -y ca-certificates curl

A continuación, crea el directorio para almacenar las claves de seguridad y descarga la clave GPG oficial de Docker:

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://docker.com -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

Finalmente, añade el repositorio oficial a tus fuentes de software de Ubuntu:

echo \
  "deb [arch=\$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://docker.com \
  \((. /etc/os-release && echo "\)VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Paso 3: Instalar Docker Engine y Plugins esenciales

Con el repositorio ya configurado, actualiza nuevamente tu índice de paquetes para que tu sistema reconozca la nueva fuente de Docker:

sudo apt update

Ahora, instala Docker Engine junto con las herramientas CLI y el plugin de Docker Compose (esencial para gestionar múltiples contenedores):

sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Paso 4: Comprobar que todo funciona

Para asegurarte de que el motor de Docker se instaló correctamente y está activo, puedes descargar y ejecutar una imagen de prueba ligera llamada hello-world:

sudo docker run hello-world

Si ves un mensaje de bienvenida en la terminal indicando que la instalación funciona correctamente, ¡felicidades! Ya tienes Docker operativo.

Paso 5: Ejecutar Docker sin ‘sudo’ (Opcional pero recomendado)

Por defecto, el comando docker requiere privilegios de administrador, lo que te obliga a escribir sudo antes de cada acción. Si quieres evitarlo y mejorar tu flujo de trabajo, añade tu usuario al grupo de Docker:

1. Añade tu usuario actual al grupo de Docker:

sudo usermod -aG docker \$USER

2. Aplica los cambios inmediatamente sin necesidad de reiniciar el equipo:

newgrp docker

A partir de este momento, podrás ejecutar cualquier contenedor simplemente escribiendo docker run.