How to Install Docker on Raspberry Pi: A Step-by-Step Guide

Ready to use Docker on your Raspberry Pi? Check out our easy-to-follow guide for a seamless installation and begin containerizing today.

Docker is a powerful tool for containerization and simplifying application deployment. At the same time, Raspberry Pi, a popular single-board computer, has become a favorite among developers for its low cost and versatility.

However, installing Docker on a Raspberry Pi can be daunting for those new to the process. But donโ€™t worry โ€“ weโ€™ve got you covered!

This article provides a step-by-step guide on installing Docker on a Raspberry Pi. Following these instructions, you can set up Docker and start quickly containerizing your applications.

Step 1: Update Raspberry Pi OS

Begin by updating the Raspberry Pi OS packages to recent versions. This way, we ensure we have a wholly up-to-date system. So, first, run the following two APT commands:

sudo apt update
sudo apt upgrade
Update packages.
Update packages.

As you can see, no updated packages are available, but if you have any, apply them before proceeding.

Step 2: Install Docker on Raspberry Pi OS

Setting up Docker on a Raspberry Pi is simple because Dockerโ€™s installation script automates the entire process. All you have to do is run the curl command below, which will download the script and pipe it to the command line for execution.

curl -sSL https://get.docker.com | sudo shCode language: JavaScript (javascript)

Wait for the installation to complete; at the end, you should receive an output similar to the one shown in the image below.

Installing Docker on Raspberry Pi.
Installing Docker on Raspberry Pi.

That’s all. To confirm the running status of the Docker service, issue the following command:

sudo systemctl is-active docker
Check service status.
Check service status.

As you can see, Docker is up and running as expected.

Step 3: Allow Non-Root User to Execute Docker Commands

So far, we have successfully installed Docker on our Raspberry Pi OS system. However, only root and users with sudo privileges can execute Docker commands by default.

So, if you now attempt to run the docker command without prefixing it with sudo, youโ€™ll get an output like this:

Trying to run the docker command as a regular user.
Trying to run the docker command as a regular user.

But donโ€™t be concerned. Thereโ€™s a simple solution. To run Docker commands as a non-root user, add your user to the โ€œdockerโ€ group. To do that, type in the following:

sudo usermod -aG docker ${USER}

In the above command, ${USER} is an environment variable that holds your username. First, reboot your Raspberry Pi OS system to apply for the new group membership.

Then, you can execute docker commands without prefixing them with sudo.

Run a Docker command as a regular user.
Run a Docker command as a regular user.

Step 4: Test the Docker Installation on Raspberry Pi

Now letโ€™s check if everything with our new Docker installation works properly. For this purpose, we will pull and run a simple container called โ€œhello-world.โ€

docker run hello-world
Docker successfully installed, up & running on raspberry Pi OS.
Docker successfully installed, up & running on Raspberry Pi OS.

Congratulations! As we can see, everything works as expected!

Uninstall Docker on Your Raspberry Pi

If you decide to uninstall Docker from your Raspberry Pi system for any reason, you can do it easily by running the command below.

sudo apt remove docker-ce docker-ce-cli docker-buildx-plugin docker-ce-rootless-extras docker-compose-plugin
Uninstall Docker on Raspberry Pi.
Uninstall Docker on Raspberry Pi.

Conclusion

Installing Docker on a Raspberry Pi can be a great way to take advantage of the Pi’s capabilities as a low-cost, energy-efficient server.

With Docker, you can easily set up and manage containers for various applications and services (check out the best ones) without worrying about compatibility issues or dependencies.

We hope that this guide has helped get you started with Docker on your Raspberry Pi and that you can now take advantage of the many benefits that Docker offers.

To learn more about Docker, check out the official Docker documentation. Additionally, we recommend our detailed guide to expand your skills with Docker and learn how to run and manage multi-container applications using Docker Compose. Happy dockering!

Bobby Borisov

Bobby Borisov

Bobby, an editor-in-chief at Linuxiac, is a Linux professional with over 20 years of experience. With a strong focus on Linux and open-source software, he has worked as a Senior Linux System Administrator, Software Developer, and DevOps Engineer for small and large multinational companies.

Think You're an Ubuntu Expert? Let's Find Out!

Put your knowledge to the test in our lightning-fast Ubuntu quiz!
Ten questions to challenge yourself to see if you're a Linux legend or just a penguin in the making.

1 / 10

Ubuntu is an ancient African word that means:

2 / 10

Who is the Ubuntu's founder?

3 / 10

What year was the first official Ubuntu release?

4 / 10

What does the Ubuntu logo symbolize?

5 / 10

What package format does Ubuntu use for installing software?

6 / 10

When are Ubuntu's LTS versions released?

7 / 10

What is Unity?

8 / 10

What are Ubuntu versions named after?

9 / 10

What's Ubuntu Core?

10 / 10

Which Ubuntu version is Snap introduced?

The average score is 68%