Cómo instalar Docker y Docker Compose en Linux, Ubuntu Server y Raspberry Pi

Docker | Instalación | Linux | Ubuntu Server | Raspberry Pi

Cómo instalar Docker y Docker Compose en Linux, Ubuntu Server y Raspberry Pi

Guía completa paso a paso para instalar Docker y Docker Compose en Debian, Ubuntu, Linux Mint y Raspberry Pi. Comandos, verificaciones y troubleshooting incluidos.

Instalación de Docker en sistemas Linux


Docker ha se ha convertido en la herramienta estándar para contenerización en Linux. La instalación es sencilla, pero existen varias formas de hacerlo: desde el repositorio oficial, mediante el script de instalación automática, o desde los repositorios de tu distribución.

En esta guía te mostramos cómo instalar Docker y Docker Compose en las plataformas más populares: Debian, Ubuntu Server, Linux Mint y Raspberry Pi. Todos los comandos son iguales o casi iguales; la principal diferencia está en la arquitectura (ARM en Raspberry Pi).

Requisitos mínimos: Linux actualizado, acceso a terminal con sudo, conexión a internet. Nada más.

Método 1: Instalación desde el repositorio oficial (RECOMENDADO)

Esta es la forma más segura y recomendada. Docker mantiene repositorios oficiales para todas las distros principales.

Paso 1: Actualiza tu sistema

sudo apt update sudo apt upgrade -y

Paso 2: Instala dependencias necesarias

sudo apt install -y ca-certificates curl gnupg lsb-release

Paso 3: Añade la clave GPG de Docker

sudo mkdir -m 0755 -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg sudo chmod a+r /etc/apt/keyrings/docker.gpg

Paso 4: Añade el repositorio de Docker

# Para Debian/Ubuntu echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Paso 5: Instala Docker

sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
¿Qué se instala? docker-ce (el motor Docker), docker-ce-cli (herramientas de línea de comandos), containerd.io (runtime de contenedores), y los plugins de Docker Compose.

Paso 6: Verifica la instalación

docker --version docker run hello-world

Si ves el mensaje de bienvenida de Docker, ¡instalación completada!

Método 2: Script automático de Docker (rápido pero menos seguro)

Docker proporciona un script que automatiza todo el proceso. Es conveniente pero no es recomendado para producción porque se salta algunas validaciones de seguridad.

curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh
Nota de seguridad: Este script descarga y ejecuta código directamente. Úsalo solo en sistemas de desarrollo o de confianza.

Guías específicas por distribución

Ubuntu Server (22.04 / 24.04)

Sigue exactamente los pasos del Método 1. Ubuntu es completamente compatible con el repositorio oficial de Docker.

# Los pasos son idénticos sudo apt update sudo apt install -y ca-certificates curl gnupg lsb-release sudo mkdir -m 0755 -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

Linux Mint (basado en Ubuntu)

Linux Mint hereda los repositorios de Ubuntu, así que el proceso es idéntico. Algunos usuarios prefieren usar el script automático por simplicidad.

Debian (Bullseye / Bookworm)

Los pasos son los mismos que para Ubuntu. Debian es totalmente compatible.

Raspberry Pi (ARM64 / ARMv7)

Raspberry Pi usa arquitectura ARM. Docker tiene soporte completo, pero ten en cuenta que algunas imágenes pueden no estar disponibles en ARM.

En Raspberry Pi OS (basado en Debian):

# Actualiza y añade repositorio oficial sudo apt update && sudo apt upgrade -y sudo apt install -y ca-certificates curl gnupg lsb-release sudo mkdir -m 0755 -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
Nota importante para Raspberry Pi: La primera vez que instales Docker en una Raspberry Pi, el proceso puede tardar varios minutos (especialmente en Raspberry Pi 3 o 4). Es normal. No interrumpas.

Configuración esencial después de la instalación

1. Inicia el servicio Docker

sudo systemctl start docker sudo systemctl enable docker

enable hace que Docker se inicie automáticamente cuando arranque el sistema.

2. Añade tu usuario al grupo docker (opcional pero recomendado)

De esta forma no necesitarás escribir sudo en cada comando:

sudo usermod -aG docker $USER

Cierra sesión e inicia de nuevo (o ejecuta newgrp docker) para que el cambio tenga efecto.

Advertencia de seguridad: Pertenecer al grupo docker es casi equivalente a tener acceso root. Úsalo solo en máquinas de confianza.

3. Verifica que todo funciona

docker ps docker run hello-world

Docker Compose: opciones de instalación

Opción A: Docker Compose como plugin (RECOMENDADO)

Si instalaste Docker desde el repositorio oficial, Docker Compose ya está incluido como plugin. Verifica:

docker compose version

Si ves la versión, ya está listo. No necesitas hacer nada más.

Opción B: Docker Compose standalone (si lo necesitas)

En caso de que necesites la versión standalone (menos común), puedes descargarla directamente:

# Detecta tu arquitectura y descarga la versión correcta DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker} mkdir -p $DOCKER_CONFIG/cli-plugins curl -SL https://github.com/docker/compose/releases/download/v2.24.0/docker-compose-linux-$(uname -m) -o $DOCKER_CONFIG/cli-plugins/docker-compose chmod +x $DOCKER_CONFIG/cli-plugins/docker-compose docker compose version
Arquitecturas soportadas: x86_64 (Intel/AMD), aarch64 (ARM 64-bit, Raspberry Pi 4/5), armv7l (ARM 32-bit, Raspberry Pi 3).

Verificación completa de la instalación

Ejecuta estos comandos para confirmar que todo está correcto:

# Ver versión de Docker docker --version # Ver información del sistema Docker docker info # Ver versión de Compose docker compose version # Ejecutar contenedor de prueba docker run --rm hello-world # Listar contenedores en ejecución docker ps

Si todos los comandos funcionan sin errores, ¡Docker está completamente instalado y operativo!

Solución de problemas comunes

Error: "Cannot connect to Docker daemon"

El servicio Docker no está ejecutándose:

sudo systemctl start docker sudo systemctl status docker

Error: "Permission denied while trying to connect to Docker daemon"

Tu usuario no está en el grupo docker:

sudo usermod -aG docker $USER newgrp docker

En Raspberry Pi: "no suitable image found"

La imagen descargada no es compatible con ARM. Asegúrate de usar imágenes que soporten tu arquitectura. Busca en Docker Hub filtrado por ARM.

Docker ocupa demasiado espacio en disco

Limpia imágenes y contenedores sin usar:

docker system prune -a
Advertencia: Este comando elimina todas las imágenes, contenedores y volúmenes no utilizados. Asegúrate de que no necesitas nada antes de ejecutarlo.

Tabla de instalación por distribución

Distribución Método recomendado Tiempo aproximado
Ubuntu Server 22.04 / 24.04 Repositorio oficial 3-5 minutos
Debian 11 / 12 Repositorio oficial 3-5 minutos
Linux Mint 21 / 22 Repositorio oficial 3-5 minutos
Raspberry Pi 4/5 (64-bit) Repositorio oficial 5-10 minutos
Raspberry Pi 3 (32-bit) Repositorio oficial 10-15 minutos

Próximos pasos después de la instalación

  • Aprende Docker Compose: Define tus primeros contenedores en un archivo YAML.
  • Explora Docker Hub: Descarga imágenes oficiales de aplicaciones populares (Nginx, PostgreSQL, etc).
  • Configura una aplicación real: Instala Portainer, Jellyfin o cualquier servicio que uses.
  • Automatiza con systemd: Configura tus contenedores para que se ejecuten al iniciar el sistema.

Documentación oficial

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Sígueme en mis redes sociales

Telegram Discord YouTube GitHub Blog Twitter

Comentarios

Publicar un comentario

Entradas populares de este blog

Cómo Instalar y configurar SERVIDOR VPN WIREGUARD en MIKROTIK 🔐 #VPN #Wireguard #Mikrotik #RouterOS

Imagen
Wireguard en Mikrotik Breve Explicación de Wireguard ¿Qué es WireGuard VPN? WireGuard es un nuevo protocolo de VPN. No se trata de un software, sino de un conjunto de instrucciones que permite crear VPNs de forma muy sencilla. Ha sido desarrollada como una alternativa a IPsec, OpenVPN y similares VPNs, pero más rápida y sencilla de usar. En esencia, WireGuard está basado en ideas del protocolo IPsec. WireGuard es una VPN extremadamente simple, pero rápida y moderna que utiliza criptografía de última generación. Su objetivo es ser más rápido, más simple, y más versátil que IPSec, evitando al mismo tiempo el enorme dolor de cabeza (sobre todo en redes con NAT). Pretende ser considerablemente más eficaz que OpenVPN. WireGuard está diseñado como una VPN de propósito general para ejecutarse en interfaces embebidas, apto para muchas circunstancias diferentes. Se ejecuta sobre el protocolo UDP, por lo tanto es considerado un túnel de capa 3. ¿Cómo funciona Wireguard VPN? WireGuard es un proto...
Read more »

Cómo instalar y configurar DSM SYNOLOGY 7.2.2 en PC | Guía completa, instalación, RAID 1, SMB

Imagen
Instalación y puesta en marcha de Synology DSM 7.2.2 en PC Vídeo ACTUALIZADO, NUEVA VERSIÓN DEL ARC LOADER:  https://youtu.be/LgghogL-UCA https://genbyte.blogspot.com/2025/08/como-convertir-pc-en-synlogy-con-6-tb.html ----- Proceso de instalación y puesta en marcha de sistema operativo DSM Synology versión 7.2.2 en un PC, concretamente un HP 800 G1 EliteDesk. El PC tendrá 3 discos SSD, uno de 120 GB para el S.O. DSM, y otros dos de 240GB cada en RAID 1 para los Datos. Los 3 dicos duros conectados al PC mediante cables SATA. Lo primero que necesitamos es descargar la imagen bootloader ARC, desde el siguiente repositorio de Gothub, también necesitamos Rufus, en este momento, es la versión 4.6. Imagen ARC:  https://github.com/AuxXxilium/arc Imagen usado en el vídeo 1.1.29:  https://github.com/AuxXxilium/arc/releases/tag/1.1.29 Rufus:  https://rufus.ie/es/ Después de descargar la imagen ARC.img, conectamos nuestro primer disco SSD de 120GB por cable o conector SATA-USB y...
Read more »

Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso.

Imagen
Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso. Vídeo tutorial paso a paso en Youtube Desarrollo Ilustración: Diagrama RED Creación de Redes (Address) ----------------------------------------------- WAN 192.168.1.0/24 LAN 192.168.88.0/24 VPN 192.168.100.0/24 Creación del Rango VPN ------------------------ 192.168.100.1 - 192.168.100.100 Creación de los Certificados ------------------------------- Los certificados que vamos a crear a continuación tendrán una validez de 10 años; days-valid=3650 Crear certificado CA ---------------------- /certificate add name=CA-tpl country="" state="" locality="" organization="" unit="" common-name="CA" key-size=4096 days-valid=3650 key-usage=crl-sign,key-cert-sign /certificate sign CA-tpl ca-crl-host=127.0.0.1 name="CA" Crear certificado Server -------------------------- /certificate add name=SERVER-tpl country="" state="" locality=...
Read more »