Kalm is optimized to work with the latest version of Kubernetes (currently 1.18.x), and is backward compatible down to 1.14.x
|Kalm version||k8s 1.15.x||k8s 1.16.x||k8s 1.17.x||k8s 1.18.x|
For smooth performance, we recommend a Kubernetes cluster with at least 4 vCPUs and 8G of memory.
Step 1: Prerequisites
Kalm can be used to manage any Kubernetes cluster. For the purpose of this tutorial, we recommend that you try kalm on Minikube localhost cluster first.
Installation of Kalm requires
kubectl, which can be installed according to the official Install and Set Up
Please make sure that the version of the
kubectl is sufficient. It is strongly recommended that you use the version corresponding to the cluster. Using an earlier version of
kubectl may cause errors in the installation process.
Step 2: Install Kalm
Before proceeding, please make sure that the current context of your
kubectl is set to the correct cluster.
Kalm can be installed as a Kubernetes Operator directly onto your cluster via:
This command installs Kalm plus a few dependencies, and typically takes 3-5 minutes to complete. Relax in the mean time, or watch this short video on how Kalm works:
The installation script will give you real-time feedback on services spinning up. Once you see Installation Complete, move on to the next step.
Step 3: Access Webserver
To enable browser access, open a port via:
Now open http://localhost:3010/
Step 4: (Optional) Configure Access
Although we can visit Kalm through localhost port forwarding, it is a good idea to setup a domain and basic login, so you can access Kalm on any computer, and share it with colleagues.
To setup permanent access, click FINISH THE SETUP STEPS button in the top navigation bar and follow the on-screen directions.
Point a domain to the cluster ip. If you don't have a domain, you can use the wildcard DNS nip.io:
For minikube, if no ip is shown, run
minikube tunnel and refresh the page.
Click CHECK AND CONTINUE. After the configuration is complete, record the generated Email and Password login information. From this point on, port-forwarding is no longer required, and you should be able to login via the domain you specified.
Congratulations! Kalm is now properly setup and running. Next, let's create our first application to see how Kalm works.