How to Use Docker on Raspberry Pi: Easy Setup and Usage

To use Docker on Raspberry Pi, first install Docker using the official convenience script or package manager. Then, run Docker commands like docker run to start containers optimized for ARM architecture on your Pi.

Syntax

Here is the basic syntax to install and use Docker on Raspberry Pi:

• curl -fsSL https://get.docker.com -o get-docker.sh: Downloads the Docker install script.
• sh get-docker.sh: Runs the script to install Docker.
• sudo usermod -aG docker $USER: Adds your user to the Docker group to run commands without sudo.
• docker run [OPTIONS] IMAGE [COMMAND]: Runs a Docker container from an image.

bash

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
sudo usermod -aG docker $USER
docker run [OPTIONS] IMAGE [COMMAND]

Example

This example shows how to install Docker on Raspberry Pi and run a simple ARM-compatible container that prints 'Hello from Docker on Raspberry Pi!'.

bash

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
sudo usermod -aG docker $USER
newgrp docker

docker run --rm arm32v7/alpine echo "Hello from Docker on Raspberry Pi!"

Output

Hello from Docker on Raspberry Pi!

Common Pitfalls

Common mistakes when using Docker on Raspberry Pi include:

• Trying to run images built for x86/x64 instead of ARM architecture, which will fail.
• Not adding your user to the docker group, causing permission errors.
• Forgetting to restart your terminal or run newgrp docker after adding your user to the Docker group.
• Not updating Raspberry Pi OS before installing Docker, which can cause compatibility issues.

bash

docker run hello-world
# This may fail on Raspberry Pi if the image is not ARM compatible.

# Correct way:
docker run --rm arm32v7/hello-world

Quick Reference

Command	Description
curl -fsSL https://get.docker.com -o get-docker.sh	Download Docker install script
sh get-docker.sh	Run Docker install script
sudo usermod -aG docker $USER	Add user to Docker group
newgrp docker	Apply new group without logout
docker run --rm arm32v7/alpine echo "Hello"	Run ARM container and print message
docker ps	List running containers
docker images	List downloaded images

Key Takeaways

Install Docker on Raspberry Pi using the official install script for easy setup.

Use ARM-compatible Docker images like arm32v7 or arm64v8 for Raspberry Pi.

Add your user to the Docker group to run Docker commands without sudo.

Restart your terminal or run 'newgrp docker' after changing group membership.

Always update Raspberry Pi OS before installing Docker to avoid compatibility issues.