Ejecutar Docker en Ubuntu no siempre es pan comido, sobre todo si falla o simplemente no funciona desde el primer momento. Quizás hayas intentado instalarlo, pero comandos como “docker” no se reconocen o los contenedores simplemente no se conectan; sí, es frustrante. Esta guía explica los métodos más comunes, desde instalaciones desde repositorios oficiales hasta paquetes sin conexión, además de algunos consejos para solucionar problemas y limpiar versiones antiguas. Porque, claro, Linux tiene su forma de complicarlo todo más de lo que debería. Una vez configurado, podrás ejecutar contenedores, probar cosas localmente o incluso desplegar en producción. Tendrás una configuración de Docker funcional sin complicaciones y algunas ideas por si las cosas se complican.
Cómo solucionar problemas de instalación y ejecución de Docker en Ubuntu
Asegúrese de que no haya paquetes Docker conflictivos u obsoletos que estén causando problemas
En primer lugar, es raro que los paquetes sobrantes no causen problemas más adelante. Retire cualquier cosa que pueda interferir:
for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove -y "$pkg" done Esto ayuda a despejar el camino. A veces, las versiones antiguas o las herramientas conflictivas causan errores de comando no encontrado o problemas de inicio del demonio. En algunas configuraciones, reiniciar después puede finalmente sincronizar todo.
Comprueba tu versión y arquitectura de Ubuntu: conoce tu entorno
Antes de comenzar con los comandos, verifique que la arquitectura de su sistema operativo y CPU sea la esperada. Ejecute:
source /etc/os-release && echo "Ubuntu codename: ${UBUNTU_CODENAME:-$VERSION_CODENAME}" dpkg --print-architecture Esto simplemente confirma que estás trabajando con el repositorio y las versiones de paquete correctas. A veces, una arquitectura incorrecta genera instalaciones defectuosas o paquetes no coincidentes.
Método 1: Instalar Docker desde el repositorio oficial de APT
Esta es la opción ideal para quienes buscan una configuración estable y fácil de administrar. Obtienes la última versión oficial de Docker con actualizaciones directamente desde el código fuente. Ayuda a evitar el caos de dependencias.
Instalar los paquetes necesarios y agregar la clave GPG
Este paso instala herramientas como ca-certificates y curl, además de añadir la clave GPG de Docker. Es bastante sencillo, pero omitir un paso aquí puede significar que apt no pueda verificar que se están extrayendo paquetes legítimos de Docker, lo cual es un problema.
sudo apt-get update sudo apt-get install -y ca-certificates curl sudo install -m 0755 -d /etc/apt/keyrings sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc sudo chmod a+r /etc/apt/keyrings/docker.asc Agregar el repositorio oficial de Docker
Aquí le indicas a tu sistema dónde encontrar los paquetes de Docker. Es un comando echo simple, pero asegúrate de reemplazar `$(./etc/os-release && echo “${UBUNTU_CODENAME}”) correctamente; a veces no se expande como se espera, especialmente si tu sistema operativo no es estándar.
echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \ $(./etc/os-release && echo "${UBUNTU_CODENAME}") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt-get update Instalar Docker Engine y las herramientas CLI
Ahora simplemente instala los contenedores y la CLI. Normalmente funciona sin problemas, pero si tu configuración es inusual, podrías necesitar especificar números de versión específicos o comprobar si hay dependencias dañadas.
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin Verifique que Docker esté instalado y ejecutándose
Si esto no genera errores, verifique el estado del demonio:
sudo systemctl status docker --no-pager docker run hello-world Esta prueba extrae una imagen pequeña y la ejecuta. Si funciona, tu configuración de Docker es básicamente correcta. En algunas máquinas, podrías necesitar agregar tu usuario al grupo de Docker para mayor comodidad:
sudo usermod -aG docker $USER newgrp docker docker run hello-world No estoy seguro de por qué, pero a veces es necesario usar newgrp o volver a iniciar sesión para que los cambios del grupo surtan efecto sin tener que reiniciar.
Actualizar o instalar versiones específicas de Docker
Si necesitas una versión en particular, consulta las disponibles en:
apt-cache madison docker-ce | awk '{ print $3 }' Luego instala tu elección como:
sudo apt-get install -y docker-ce=<version> docker-ce-cli=<version> containerd.io Porque, a veces, solo necesitas esa compilación específica por razones de compatibilidad; ten en cuenta que, en algunas configuraciones, las degradaciones o versiones específicas pueden resultar complicadas si los repositorios no se actualizan.
Método 2: Instalación sin conexión mediante paquetes.deb
Genial cuando los servidores están aislados o el acceso a internet es inestable. Primero tienes que descargar todos los archivos y luego instalarlos localmente.
Descargar paquetes de Docker manualmente
Ve al repositorio de Ubuntu de Docker y selecciona tu arquitectura (como amd64 o arm64 ).Descarga estos archivos.deb:
containerd.io_<version>_<arch>.debdocker-ce_<version>_<arch>.debdocker-ce-cli_<version>_<arch>.debdocker-buildx-plugin_<version>_<arch>.debdocker-compose-plugin_<version>_<arch>.deb
Una vez descargado, instalar todo de una vez:
sudo dpkg -i./containerd.io_*_*.deb \./docker-ce_*_*.deb \./docker-ce-cli_*_*.deb \./docker-buildx-plugin_*_*.deb \./docker-compose-plugin_*_*.deb Esto parece un poco más complicado, pero es la única opción sin Internet y, en algunos sistemas, funciona de manera más confiable.
Método 3: Usar el script de conveniencia oficial de Docker
Si la velocidad es más importante que la seguridad (¡no recomendado para producción!), simplemente ejecute:
curl -fsSL https://get.docker.com -o get-docker.sh sudo sh./get-docker.sh --dry-run # preview, then run without --dry-run sudo sh./get-docker.sh Este método descarga todo y lo configura sin complicaciones.¿La desventaja? No hay control sobre versiones ni dependencias, y es un poco inseguro para sistemas críticos.
Instalación de Docker Desktop en Ubuntu
Para una experiencia GUI con Docker, Desktop añade una capa de facilidad de uso, similar a Docker en la bandeja del sistema. Necesitarás Ubuntu 22.04 o posterior, con la Terminal de GNOME si no usas GNOME.
Configurar el repositorio de escritorio e instalarlo
Básicamente, repita la configuración del repositorio del Método 1, pero luego instale:
sudo apt-get install -y./docker-desktop-amd64.deb Iniciarlo y habilitarlo para el inicio automático:
systemctl --user start docker-desktop systemctl --user enable docker-desktop Comprobaciones posteriores a la instalación y resolución de problemas comunes
docker run hello-world docker run -d -p 8080:80 --name web nginx docker ps sudo systemctl enable docker Algunos problemas típicos:
docker: command not found→ Reinstale Docker CLI o verifique que su RUTA incluya /usr/bin o /usr/local/bin.- No se puede conectar al demonio → Asegúrese de que el servicio Docker esté activo y que su usuario esté en el grupo Docker.
- Errores al extraer imágenes → Verifique la configuración de red, el proxy, el DNS o la sincronización horaria (NTP).A veces, Docker no puede acceder a Docker Hub.
- Problemas de firewall → Es posible que necesite agregar reglas en la cadena DOCKER-USER o en su firewall para permitir el tráfico del puerto del contenedor.
Desinstalar Docker si es necesario
sudo apt-get purge -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras sudo rm -rf /var/lib/docker /var/lib/containerd sudo rm -f /etc/apt/sources.list.d/docker.list /etc/apt/keyrings/docker.asc Resumen
Instalar Docker en Ubuntu puede parecer un poco complicado, especialmente con todos los componentes: versiones del kernel, dependencias y firewall. Pero una vez que funciona, es bastante fiable para la gestión de contenedores. Los métodos oficiales cubren prácticamente cualquier escenario, desde instalaciones online hasta configuraciones offline, y los pasos de solución de problemas suelen solucionar los problemas. Si la configuración finalmente funciona, es un alivio, y podrás empezar a construir o desplegar contenedores prácticamente de inmediato.
Resumen
- Elimine primero los paquetes conflictivos
- Elija el método de instalación adecuado según su entorno
- Verifique que Docker se ejecute con una prueba rápida de contenedor
- Mantenga Docker actualizado y verifique las reglas del firewall si es necesario
- Elimine las configuraciones antiguas de forma limpia si cambia los métodos