Install Docker and Docker-Compose on your Raspberry Pi

In this tutorial, we will cover how to install docker and docker-compose on a raspberrypi and run a simple container.

One thing to keep in mind through all of this is that the pi is built on an ARM architecture as opposed to Intel. As a result, you will only be able to run containers built for the ARM architecuture.

Fortunately, Docker Official Images should all support this architecture as per this post

That said, let’s get started.

First, you can install docker with an easy install script as follows:

curl -sSL | sh

Test that the daemon is working with a classic hello world:

docker run --rm hello-world

You should see the following output:

Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
c1eda109e4da: Pull complete
Digest: sha256:2557e3c07ed1e38f26e389462d03ed943586f744621577a99efb77324b0fe535
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
 $ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:

For more examples and ideas, visit:

If you get a permissions error, be sure to add your user to the docker group:

usermod -aG docker <your_user>

And then try again.

Now that we know docker is working, let’s go and grab docker-compose.

First, install pip:

curl -o && sudo python3

Now install docker-compose with:

sudo pip3 install docker-compose

Finally, test that things are working by creating a docker-compose file:

vim docker-compose.yml

If you don’t have vim installed, you can grab it with:

sudo apt-get update && sudo apt-get install vim -y

Now in docker-compose.yml put:

version: '3'
      - 5000:8000
    image: python:3.7-alpine
    command: "python -m http.server 8000"

Then start the service with:

docker-compose up -d

Now you can curl the service with:

curl -iv

and you should get a response similar to the following:

* Rebuilt URL to: localhost:5000/
*   Trying ::1...
* Connected to localhost (::1) port 5000 (#0)
> GET / HTTP/1.1
> Host: localhost:5000
> User-Agent: curl/7.52.1
> Accept: */*
* HTTP 1.0, assume close after body
< HTTP/1.0 200 OK
HTTP/1.0 200 OK
< Server: SimpleHTTP/0.6 Python/3.7.2
Server: SimpleHTTP/0.6 Python/3.7.2
< Date: Sun, 10 Feb 2019 04:08:24 GMT
Date: Sun, 10 Feb 2019 04:08:24 GMT
< Content-type: text/html; charset=utf-8
Content-type: text/html; charset=utf-8
< Content-Length: 915
Content-Length: 915

<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Directory listing for /</title>
<h1>Directory listing for /</h1>
<li><a href=".dockerenv">.dockerenv</a></li>
<li><a href="bin/">bin/</a></li>
<li><a href="dev/">dev/</a></li>
<li><a href="etc/">etc/</a></li>
<li><a href="home/">home/</a></li>
<li><a href="lib/">lib/</a></li>
<li><a href="media/">media/</a></li>
<li><a href="mnt/">mnt/</a></li>
<li><a href="opt/">opt/</a></li>
<li><a href="proc/">proc/</a></li>
<li><a href="root/">root/</a></li>
<li><a href="run/">run/</a></li>
<li><a href="sbin/">sbin/</a></li>
<li><a href="srv/">srv/</a></li>
<li><a href="sys/">sys/</a></li>
<li><a href="tmp/">tmp/</a></li>
<li><a href="usr/">usr/</a></li>
<li><a href="var/">var/</a></li>
* Curl_http_done: called premature == 0
* Closing connection 0

Provided you get a 200 response, your docker-compose service is up and running!

Now you can bring the service down with docker-compose down, and you’re all done.

Leave a Reply

Your email address will not be published. Required fields are marked *