Quickstart

Getting started with mogenius is easy. Here’s a walkthrough of the most important steps for connecting your cluster and creating a workspace.

​

1. Sign up​

First, sign up for a mogenius account. You can use a social login (Github, Gitlab, Google, Microsoft), or your email address.

​

2. Create an organization

Create an organization, which represents the highest level in the mogenius account hierarchy. This allows you to have multiple organizations, each fully isolated with its own access management and list of clusters.

​

3. Connect a Kubernetes cluster

Now, let’s move on to the exciting part: connecting to a Kubernetes cluster. Once you have connected your cluster, you will be able to create workspaces for monitoring and navigating your applications, as well as deploying containers to your cluster with the built-in pipeline tools.

​

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 minikube, Docker Desktop, or k3s, is also a great option.
• A working installation of Helm and kubectl
• OR optionally the mogenius CLI
• Kubernetes cluster admin permissions

After creating your organization, add a new cluster. Enter a name (this will only be used to display the cluster in mogenius) and proceed to install the operator.

​

4. Install mogenius on the cluster

Before you continue, make sure that you have a running Kubernetes cluster where you have admin access. Next, you will install the mogenius operator on the cluster using Helm or mocli to connect your cluster with the mogenius platform.

Copy the Helm or mocli command. Open a terminal and make sure that your kubecontext is set to the cluster that you want to connect with mogenius. Paste and execute the install command, return to mogenius, and click “I ran the command.” The UI will confirm once the operator has established a connection with the mogenius controlplane.

Once connected, the operator will check if a metrics server is present on the cluster. If not, it will be installed automatically.

Done - your cluster is ready! 🥳 You can now create your first workspace.

​

8. Create a workspace

Head to the Workspaces section in your organization and click Create workspace. Select your cluster from the list, and enter a name for your workspace.

Next, select the resources that you want to manage in your workspace. You can select them based on namespaces, or Helm releases from the cluster.

Finally, invite team members and define their roles and permissions. They’ll receive an invitation email right afterwards.

/

​

9. Congratulations - your workspace is ready 🎉

What’s next?
Your dashboard is ready to start monitoring your applications in real-time. Check the status of your resources, monitor events, and browse through logs, metrics, or the resource topology for troubleshooting issues. Want to deploy a new application? Use the built-in pipeline tools to connect a registry, deploy a pipeline starter, or start from scratch with a YAML manifest.