En este artículo se detalla el proceso completo para instalar Docker en una Raspberry Pi 4 utilizando Raspbian (Debian 12 Bookworm). Se incluye configuración del repositorio oficial, verificación y ajustes opcionales según el gestor de red.
📌 Requisitos
Raspberry Pi 4
Raspbian Bookworm actualizado
Acceso a terminal con privilegios
sudoConexión a internet
🔧 1. Preparar el sistema
Instalar dependencias necesarias:
sudo apt update
sudo apt install apt-transport-https ca-certificates curl gnupg lsb-release
🔐 2. Agregar clave GPG oficial de Docker
curl -fsSL https://download.docker.com/linux/debian/gpg | \
sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
📦 3. Agregar repositorio oficial
echo "deb [arch=arm64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] \
https://download.docker.com/linux/debian $(lsb_release -cs) stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
Actualizar índices:
sudo apt update
⚠️ Nota sobre reinicio
No es estrictamente obligatorio, pero puede evitar problemas de entorno:
sudo reboot
🐳 4. Instalar Docker
sudo apt install docker-ce docker-ce-cli containerd.io
Instalar soporte para Docker Compose (plugin clásico o moderno según repos):
sudo apt install docker-compose
✅ 5. Verificar instalación
Ejecutar contenedor de prueba:
sudo docker run hello-world
Esto descarga automáticamente la imagen desde Docker Hub y ejecuta un contenedor de validación.
👤 6. Ejecutar Docker sin sudo
Agregar el usuario actual al grupo docker:
sudo groupadd docker
sudo usermod -aG docker "$USER"
newgrp docker
Verificar:
docker run hello-world
🔄 7. Habilitar Docker al iniciar el sistema
sudo systemctl enable docker.service
sudo systemctl enable containerd.service
🌐 8. Consideración sobre gestor de red (opcional)
En Bookworm, el sistema usa por defecto NetworkManager, por lo que dhcpcd generalmente no está instalado. En ese caso, no es necesario hacer nada adicional.
🔍 Verificar qué gestor estás usando
which dhcpcd
sudo systemctl status NetworkManager
nmcli device status
⚠️ Caso específico: uso de dhcpcd
Si tu sistema utiliza dhcpcd, puede haber conflictos con interfaces virtuales de Docker.
Editar:
sudo nano /etc/dhcpcd.conf
Agregar al final:
denyinterfaces veth*
Reiniciar servicio:
sudo systemctl restart dhcpcd.service
🎯 Conclusión
La instalación de Docker en Raspberry Pi con Bookworm es directa si se utiliza el repositorio oficial. El único punto a considerar es el gestor de red: en sistemas modernos no suele requerir ajustes, pero en configuraciones heredadas con dhcpcd puede ser necesario.
🧠 Recomendación
Para entornos productivos:
Evitar usar
sudoen Docker (usar grupo)Mantener imágenes actualizadas
Considerar uso de
docker compose(plugin moderno)
