Skip to content
Kubernetes on RaspberryPi
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Kubernetes on RaspberryPI

This sets up a one node Kubernetes cluster on a RaspberryPI. This is based on the Hypriot Docker image for RPi.

Why ? Because it is the easiest way to start experimenting with containers on ARM architectures which can be extremely useful for the IoT and Embedded business. It can also be a great platform to investigate scalability issues of both Docker and Kubernetes.


You will need a RaspberryPi and you will need to have installed the Hypriot OS image on it

For the impatient:

  1. Clone this repository on your Pi

    $ git clone

    $ cd ./k8s4pi

  2. Run the script

    $ ./

  3. Enjoy

The longer version:

We use the Kubernetes kubelet running as a systemd unit to monitor a few Docker containers that make up the Kubernetes cluster. The Kubelet binary for ARM is downloaded and installed in /usr/bin/kubelet, a manifest is copied to /etc/kubernetes/manifests/kubernetes.yaml which represents a Kubernetes Pod that make up all the required containers.

In this pod we have:

  1. An etcd container. Which we run by building an etcd image from scratch on the PI.

  2. Several containers based on the Hyperkube image. Hyperkube is a single binary that can start all the Kubernetes components: API server, controller, scheduler. We build a local Hyperkube image.

  3. Then a little trick. Kubernetes does assume that you will run the nodes on x86_64 and automatically pulls an image called the pause container. This container is used to get an IP and share that IP with all the containers in the pod. For the PI, we need to run this pause container on ARM, we trick Kubernetes by building the image locally after having compiled the pause Golang code for ARM.

  4. Finally, we download the Kubernetes client kubectl for ARM from the official release:

    $ curl -fsSL -o kubectl

The ARM binaries for the kubelet and hyperkube are downloaded from

You can’t perform that action at this time.