Instalación de Docker en Raspberry Pi 4 con Raspbian Bookworm

 

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 sudo

• Conexió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 sudo en Docker (usar grupo)

• Mantener imágenes actualizadas

• Considerar uso de docker compose (plugin moderno)

---