Guía paso a paso para instalar Docker Engine en una Raspberry Pi 5 con Raspberry Pi OS (64-bit).
- Raspberry Pi 5
- Raspberry Pi OS 64-bit (Bookworm recomendado)
- Acceso a terminal con usuario con privilegios
sudo - Conexión a internet
Antes de instalar cualquier paquete, asegúrate de que el sistema esté actualizado:
sudo apt update && sudo apt upgrade -yLimpia cualquier versión previa de Docker para evitar conflictos:
for pkg in docker.io docker-doc docker-compose podman-docker containerd runc; do
sudo apt remove -y $pkg
doneInstala los paquetes que permiten a apt usar repositorios sobre HTTPS:
sudo apt install -y \
ca-certificates \
curl \
gnupg \
lsb-releasesudo install -m 0755 -d /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.gpgecho \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/nullActualiza el índice de paquetes e instala Docker:
sudo apt update
sudo apt install -y \
docker-ce \
docker-ce-cli \
containerd.io \
docker-buildx-plugin \
docker-compose-pluginComprueba que Docker se instaló correctamente ejecutando el contenedor de prueba oficial:
sudo docker run hello-worldSi ves un mensaje de bienvenida de Docker, ¡la instalación fue exitosa! 🎉
Por defecto, Docker requiere sudo. Para usarlo como usuario normal, agrégalo al grupo docker:
sudo usermod -aG docker $USER
⚠️ Importante: Cierra sesión y vuelve a iniciarla para que el cambio surta efecto. También puedes ejecutarnewgrp dockerpara aplicarlo en la sesión actual sin reiniciar.
docker run hello-worldPara que Docker inicie automáticamente con el sistema:
sudo systemctl enable docker
sudo systemctl enable containerd| Comando | Descripción |
|---|---|
docker --version |
Muestra la versión de Docker instalada |
docker compose version |
Muestra la versión de Docker Compose |
sudo systemctl status docker |
Estado del servicio Docker |
docker info |
Información detallada del sistema Docker |
docker ps |
Lista los contenedores en ejecución |
docker run -d -p 8080:80 --name mi-nginx nginxAbre tu navegador en http://<IP-de-tu-Pi>:8080 y deberías ver la página de bienvenida de Nginx.
Para detenerlo y eliminarlo:
docker stop mi-nginx
docker rm mi-nginxEl usuario no está en el grupo docker. Ejecuta:
sudo usermod -aG docker $USER && newgrp dockerEl servicio no está corriendo. Inícialo con:
sudo systemctl start dockerDocker en Raspberry Pi 5 usa la arquitectura linux/arm64. Asegúrate de usar imágenes compatibles. Puedes verificar con:
docker info | grep ArchitecturePortainer es una interfaz web para gestionar Docker visualmente — contenedores, imágenes, volúmenes y redes — todo desde el navegador, sin usar la terminal.
docker volume create portainer_data
docker run -d \
-p 8000:8000 \
-p 9443:9443 \
--name portainer \
--restart=always \
-v /var/run/docker.sock:/var/run/docker.sock \
-v portainer_data:/data \
portainer/portainer-ce:latestLuego abre en tu navegador:
https://<IP-de-tu-Pi>:9443
⚠️ Portainer usa HTTPS con certificado autofirmado. El navegador mostrará una advertencia — ignórala y selecciona "Continuar de todas formas".
La primera vez te pedirá crear un usuario administrador y listo.
Si al instalar Portainer aparece este error, el grupo docker no está activo en la sesión actual. Ejecuta:
newgrp dockerY vuelve a correr los comandos de instalación. Si persiste, cierra la sesión SSH (exit), vuelve a conectarte y reintenta.
MIT — libre de usar y modificar.