MicroK8s deployment guide

This document outlines the installation steps for single node installation using Multipass VM and MicroK8s.

Install MicroK8s with Multipass

First, install Multipass for your operating system:


With multipass installed, you can now create a VM to run MicroK8s. At least 8 Gigabytes of RAM and 40G of storage is recommended – you can pass these requirements when you launch the VM:

multipass launch --name microk8s-vm --mem 8G --disk 40G --cpus 4 # 8G ram for Istio, recommended

You can now find the IP address which has been allocated by running:

multipass list

Will return something like:

Name State IPv4 Release
microk8s-vm RUNNING Ubuntu 18.04 LTS

Take a note of this IP as you will need to add it to your params.yaml.

Run a shell into your VM:

multipass shell microk8s-vm

Install the MicroK8s snap and configure the network:

sudo snap install microk8s --classic --channel=1.18/stable
sudo iptables -P FORWARD ACCEPT

You will also need to add ubuntu user to microk8s group as follows:

sudo usermod -a -G microk8s ubuntu
# Re-enter bash session for group changes

Then, enable the following required add-ons:

sudo microk8s.enable storage dns rbac dashboard

Enable TokenRequest feature (required by Istio) by passing in extra argument to the api server.

nano /var/snap/microk8s/current/args/kube-apiserver

If you don't see any content, try exiting the multipass vm and entering again.

Add the lines:


Make sure this line is set to these values:


Save your changes. Execute to make changes take effect

sudo systemctl restart snap.microk8s.daemon-apiserver

Check microk8s is running with microk8s status


If you see a "not running" error, run microk8s inspect.

  • Since the api server was just changed, it's most likely that's where the error is.
  • Check what reports as "FAIL"
  • Assuming it's the api server
  • Untar the report file, go to the daemon-apiserver folder, open journal log file.
  • Search for "error" and see what comes up.

Install Onepanel

  1. Download the latest opctl for your operating system from our release page.

  2. Run the following command to initialize a params.yaml template for microk8s:

opctl init --provider microk8s

If you don't have a loadbalancer, and want to use a local one, you can use metallb.

opctl init --provider microk8s --enable-metallb
  1. Populate params.yaml before applying, follow the instructions in the template, you can also refer to the configuration files section.

See configuration metallb for metallb specific details.

  1. Get Kubernetes config from MicroK8s:
multipass exec microk8s-vm -- /snap/bin/microk8s.config > kubeconfig
  1. Finally, run the following command to deploy to your cluster:
KUBECONFIG=./kubeconfig opctl apply

The CLI will display the URL for accessing Onepanel once the deployment completes.

  1. To get access to this new cluster via browser, we need to carry out extra steps.

Example request flow

Request Flow with Multipass

Execute these steps in the host machine.

multipass list

Grab the IP address for your microk8s. Example:

Name State IPv4 Image
microk8s-vm Running Ubuntu 18.04 LTS

Add an entry to your hosts file to point to the fqdn you setup in params.yaml Example entry:

# The Fully Qualified Domain (FQDN) where Onepanel will be hosted.
# If `domain` above is set to example.com or sub.example.com, then your FQDN could be: app.example.com or app.sub.example.com respectively
fqdn: app.alex.xyz

Entry to /etc/hosts app.alex.xyz

Adding this entry means the host browser will try to access the multipass vm we setup for microk8s.

Next, enter into multipass VM

multipass shell microk8s-vm
Execute inside the multipass VM
microk8s.kubectl get services -n istio-system
istio-ingressgateway LoadBalancer 15020:31979/TCP,80:31394/TCP,443:30038/TCP,15029:32204/TCP,15030:32688/TCP,15031:31420/TCP,15032:30575/TCP,15443:30386/TCP 3d3h

Inside the multipass VM, add an entry to the /etc/hosts file.

sudo nano /etc/hosts app.alex.xyz

Once you have entered and saved the host change, verify you the onepanel website is running.

curl app.alex.xyz # Your params.yaml fqdn entry

Example output.

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<base href="/">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="icon" type="image/png" sizes="32x32" href="assets/icon/favicon.png">
<link rel="icon" type="image/png" sizes="96x96" href="assets/icon/favicon.png">
<link rel="icon" type="image/png" sizes="16x16" href="assets/icon/favicon.png">
<link rel="stylesheet" href="styles.9b8cd86ace5a9057a37e.css"></head>
<script src="runtime-es2015.edb2fcf2778e7bf1d426.js" type="module"></script><script src="runtime-es5.edb2fcf2778e7bf1d426.js" nomodule defer></script><script src="polyfills-es5.6696c533341b95a3d617.js" nomodule defer></script><script src="polyfills-es2015.2987770fde9daa1d8a2e.js" type="module"></script><script src="main-es2015.b17adb3826cd9f5e4a29.js" type="module"></script><script src="main-es5.b17adb3826cd9f5e4a29.js" nomodule defer></script></body>

You can debug the request with curl -vvv app.alex.xyz

We need a listener running on port 80. That listener should direct traffic to the istio gateway.

sudo apt install socat
sudo socat TCP-LISTEN:80,fork TCP:app.alex.xyz:80

This will run actively in the current terminal prompt.

Now, go back to your host machine, open your internet browser and go to: app.alex.xyz.

You should see the website load up.

  1. Use the following command to get your auth token to log into Onepanel:
KUBECONFIG=./kubeconfig opctl auth token