Jump to main content

Installing MicroK8s on a Raspberry Pi

Note: Running Kubernetes can cause a lot of I/O requests and pressure on storage. It is not recommended to use a USB stick as primary storage when running MicroK8s.

Running MicroK8s on some ARM hardware may run into difficulties because cgroups
(required!) are not enabled by default. This can be remedied on the Rasberry Pi
by editing the boot parameters:

sudo vi /boot/firmware/cmdline.txt

Note: In some Raspberry Pi Linux distributions the boot parameters are in `/boot/firmware/nobtcmd.txt`.

And adding the following:

cgroup_enable=memory cgroup_memory=1

To address disk performance issues often present on Raspberry Pi see the troubleshooting section.

Kernel modules

For Ubuntu 21.10+ it is necessary to install extra kernel modules:

sudo apt install linux-modules-extra-raspi

Then restart MicroK8s:

sudo microk8s stop; sudo microk8s start


Installation is then via the snap as usual:

sudo snap install microk8s --classic --channel=1.30

Last updated a month ago. Help improve this document in the forum.