Skip to main content

Your submission was sent successfully! Close

Thank you for signing up for our newsletter!
In these regular emails you will find the latest updates from Canonical and upcoming events where you can meet our team.Close

Thank you for contacting us. A member of our team will be in touch shortly. Close

An error occurred while submitting your form. Please try again or file a bug report. Close

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 versions before 24.04 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

Installation is then via the snap as usual:

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

Last updated 4 months ago. Help improve this document in the forum.