Kalm is optimized to work with the latest version of Kubernetes (currently 1.18.x), and is backwards 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 using Minikube localhost cluster first.
Installation of Kalm requires kubectl, which can be installed according to the official Install and Set Up kubectl docs.
Please make sure that the version of 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 meantime, or watch this short video on how Kalm works:
The installation script will give you real-time feedback of 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 acess, click FINISH THE SETUP STEPS button in the top navigation bar and follow the onscreen 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 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.