Installing mogenius
Connect your own Kubernetes cluster by installing the mogenius operator on the cluster.
mogenius allows you to connect with Kubernetes clusters by installing the mogenius operator on a cluster. Once installed, you can start creating workspaces and manage Kubernetes workloads through the mogenius platform. To begin the installation process, you’ll first need to add a cluster in mogenius.
Prerequisites
To successfully complete the next steps, you will need the following:
- A Kubernetes cluster. We recommend a managed Kubernetes service, like EKS (Amazon AWS), AKS (Microsoft Azure) or GKE (Google Cloud Platform), but any cluster with Kubernetes version 1.24 or higher will work. To get started, a local Kubernetes like Docker Desktop, k3s, or minikube is also a great option.
- A working installation of
Helm
andkubectl
- OR optionally the mogenius CLI
- Kubernetes cluster admin permissions
Resource requirements
The mogenius operator is deployed to your Kubernetes cluster using Helm. It will require at least 0.5 vCPU and 128 MB RAM.
Add a cluster in mogenius
In your organization open “Clusters” and select “Add cluster.” Enter a display name for your cluster and confirm.
This will create a management pane for a Kubernetes cluster in mogenius. It will not create an actual Kubernetes cluster.
Install the operator
mogenius connects to your Kubernetes cluster via an operator that you’ll need to deploy on Kubernetes. In the next step you will have two options to do this: using Helm, or the mogenius CLI.
Helm install
Retrieve the Helm install command from the user interface and run it on a terminal. Make sure that your kubecontext is set to the right Kubernetes cluster. The command will look something like this.
mogenius CLI
Install the mogenius CLI, on your terminal perform a mocli login
and then run the following command.
You’ll be asked to confirm the organization, the cluster that you want to connect, and your current kubecontext before the operator is being deployed.
Metrics server
Once the operator is installed, it will check if a metrics server is present on the cluster. If not, it will be automatically installed.
That’s it - your cluster is connected and you can now create workspaces!
Troubleshooting
If you’re encountering issues with installing the operator, check out common problems in the section Troubleshooting clusters.
Was this page helpful?