Kubeflow on MicroK8s
This guide describes how to deploy and run Kubeflow locally with MicroK8s - a small enterprise Kubernetes cluster.
Kubeflow is already built into MicroK8s as an add-on. This means once you install MicroK8s, you can enable Kubeflow straight away.
Alternatively, you can install MicroK8s on a Linux appliance with Multipass, which gives you a disposable Ubuntu command line on Windows, macOS or Linux. Refer to the official documentation for more details.
Installing and enabling Kubeflow using MicroK8s
To get Kubeflow running using MicroK8s, you’ll need to install MicroK8s, enable basic services, and then enable Kubeflow.
Note: You need MicroK8s version 1.18, 1.19, 1.20 or 1.21 to enable and run Kubeflow. The latest version (1.22) is not currently supported by Kubeflow itself.
Install MicroK8s by running the following command:
sudo snap install microk8s --classic --channel=1.21/stable
Add yourself (current user) to admin group:
sudo usermod -a -G microk8s $USER sudo chown -f -R $USER ~/.kube
You will have to
exitthe current session and log in again for this change to take effect.
Verify that MicroK8s is running:
microk8s status --wait-ready
Deploy Kubeflow by running this command:
microk8s enable kubeflow
The deployment process may take a few minutes. Once it is complete, the script will print out the port number and credentials to access the Kubeflow dashboard.
Optional: To enable NVIDIA GPU hardware support, also run
microk8s enable gpu.
Accessing the Kubeflow dashboard
On your Linux machine
If you installed MicroK8s directly on your Linux machine, you can view the Kubeflow dashboard as follows:
- Open a web browser window.
- Access the link provided after you have enabled Kubeflow (for example,
On Windows, macOS, Multipass or a virtual machine
When running MicroK8s on Windows, macOS, Multipass or a virtual machine, you need to create a SOCKS proxy to access the Kubeflow dashboard:
Log out from the current session in your terminal using the
Re-establish connection to the machine using
SSH, enabling SOCKS proxy with the
In the VM case, run the following command, where
<machine_public_ip>is your machine’s public IP:
ssh -D9999 ubuntu@<machine_public_ip>
On Windows, macOS or Multipass, you can check for the IP first with:
and then, run this command, replacing
<multipass_public_ip>with that IP:
ssh -D9999 multipass@<multipass_public_ip>
In your host operating system or browser, go to Settings > Network > Network Proxy, and enable SOCKS proxy pointing to:
Finally, access the Kubeflow dashboard by:
- Opening a new web browser window.
- Accessing the link provided after you have enabled Kubeflow (for example,
If you are having issues with the MicroK8s Kubeflow add-on, you can try a few alternatives:
- Install the Kubeflow Charmed Operators directly following the respective documentation using MicroK8s as a Kubernetes.
- Refresh your MicroK8s installation to the tip version via
sudo snap refresh microk8s --classic --channel=edge. This might be useful if a fix has been released in the
edgechannel of the MicroK8s snap and not yet in the default
- Re-install the tip version of MicroK8s with
sudo snap install microk8s --classic --channel=edge, and re-enable the Kubeflow add-on.
If none of the above fixes your issue, please:
- MicroK8s troubleshooting docs
- MicroK8s getting started docs
- MicroK8s Kubeflow add-on docs
- Addittional docs in Charmed Kubeflow
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.