Here is a step-by-step guide on how to deploy the UMH stack using minikube, a tool to quickly spin up a Kubernetes cluster in your local machine. This method is quicker than using a virtual machine with k3os, but less reliable. We suggest using minikube only for small tests.

⚠ Bear in mind that this way of setting up the UMH stack is not recommended. For testing and development purposes we recommend a k3d installation.

If you are using a different way to install the software, make sure to install the following versions. Specifically installing minikube directly from the website results in a new version, which is not supported yet. Older versions are also not supported anymore.

• minikube 1.26.1
• Kubernetes 1.24.3
• Helm 3.10

Requirements

• Operating system (64-bit):
  • Windows 10 version 2004 and higher or Windows 11
• Hardware:
  • CPU: 2 cores or more
  • RAM: 8GB or more
  • Storage: 10GB free

Dependencies

1. Verify that you have WSL installed.
   • Open Powershell and type wsl --status. If you get an error you probably need to install it. Refer to the Microsoft documentation on how to do that.
2. Docker Desktop
   • You can follow the Docker documentation here.
3. Chocolatey
   • Read how to do that here.

Installation

1. Open a PowerShell terminal. Be sure to use the option Run as Administrator.

2. Install minikube

   choco install minikube

   when using Ubuntu you can also use the following command

   curl -LO <https://storage.googleapis.com/minikube/releases/v1.26.1/minikube-linux-amd64> && sudo install minikube-linux-amd64 /usr/local/bin/minikube

3. Install helm

   choco install kubernetes-helm

4. Install kubectl

   choco install kubernetes-cli

5. Set the default driver for minikube. We recommend Docker, but you can use a variety of drivers. Read the Minikube docs for further information.

   minikube config set driver docker