Install Docker Raspberry Pi

2 min read
  1. How To Install Docker Raspberry Pi Buster

Installing Docker on a Raspberry Pi is as easy as following the official Docker installation guide. This document contains the steps to install Docker in a wide range of Debian based systems, including Raspbian. As the steps are in one document you have to jump to different sections. To make it clearer / easier, I’ll just show the necessary steps for Raspbian.

Docker for the Raspberry Pi has support for Raspbian Jessie, Stretch, and Buster. Installing Docker to the Raspberry Pi Thanks to a nifty install script developed by the Docker team, installing the container software is incredibly simple. Dec 30, 2019 Docker for the Raspberry Pi has support for Raspbian Jessie, Stretch, and Buster. Installing Docker to the Raspberry Pi Thanks to a nifty install script developed by the Docker team, installing the container software is incredibly simple.


Remove eventually installed obsolete docker versions.


Installation on Raspbian is done via convenience script. Read the warning text carefully, as you are going to install packages as root without really knowing what Docker is going to install. As recommended, you should check the content of the downloaded script. I’d like to have Docker also share a checksum for the file in their documentation.


The convenience script adds a Docker repository to your apt configuration. From now on, updates and package management is taken care of via apt.

Additional post-installation steps include running docker as non-root user as well as the docker documentation on post-installation. I tried to get docker running as a non-root user, but in my case the daemon always stopped with an error message. Maybe you have more luck.

So, you've just gotten your raspberry pi, I know I just did at least, and you want to set it up with docker so you can bring all of your favorite applications to this powerful piece of technology. Well then you're in the right place I'll be showing you how to setup raspberry pi with docker using raspbian os

Updating your raspberry pi

To start off update your raspberry pi to the latest version using the following command


The following command simply updates your raspberry pi to the newest version that way you won't have any issues. The command can take a couple minutes to an hour or so depending on your network speed and how much you have to update

When you run the command the output should look something along the lines of this

Downloading docker

After you've updated your raspberry pi it's time to install docker, once again it's quite simple to do so just run the command

which will get the docker install script for docker if you want to run the test branch of docker use the command

You can verify that you've downloaded the script by running ls and verifying the output shows either or

Once the file is downloaded you want to run it. Execute the script by running the following command

Now if it does not run the script you will have to run sudo chmod +X ./ This just gives the script the E(x)ecute tag hence the +. Afterward, re-run

It will then attempt to install docker automatically for you, you can for the most part safely ignore all the stuff that comes up in the terminal as it's just the command it's doing

The output looks something like this

Verifying the install

Once the command is done running you can verify that docker is installed by running

Which should return something along the lines of this

If it returns -bash: docker: command not found restart your raspberry pi and attempt to run the command again. If it still doesn't work run the install script again

Next up we'll be going through how to make docker work without adding sudo first, if you're not interested in that you can skip over that section and move straight to Hello-World

To make docker run without root you need to create a user group to access the docker container you can do such by running the following command

replace <user> with your username which by default is pi
For the changes to take effect you have to log out and log back into your account or you can optionally run this command

Once again replace <user> with your username

For the sake of tutorial, I'll just be running the reboot command which restarts the raspberry pi

Note: if you decide to do it this way you have to ssh into your raspberry pi again

As with all programming languages or tools nowadays the first thing you do is Hello World so let's get to it

To run the hello world docker container simply write

If all is well it should return this

and that's it. Well done! now you're well on your way to learning docker

Setting up docker-compose (optional)

How to install docker raspberry pi

So the new standard nowadays is setting up docker containers using docker-compose

Since the docker install doesn't come with this you have to install this manually

Installing python3

To run docker-compose you need python3You can get it by running the following commands

Installing docker-compose

After you've installed the dependencies above you can install using pip3 by running this command

How To Install Docker Raspberry Pi Buster

and that's it now you can use docker-compose in addition to docker! Here's me attempting to setup pi-hole using docker-compose