<img src="https://ws.zoominfo.com/pixel/JHVDdRXH2uangmUMQBZd" width="1" height="1" style="display: none;">

Weaveworks 2022.03 release featuring Magalix PaC | Learn more

Welcome to Magalix Documentation!

These pages cover what Magalix is, how to get started using it, and reference materials for its features and supported cloud providers.

Get started quickly, and get all your questions answered now!

Talk to an Expert

Connecting your first cluster

The first time you log into your account you will find a kubectl command pre-fabricated to connect your first Kubernetes cluster to Magalix backend. Copy and paste that command into your console as instructed on the welcome page.


If your Cluster is RBAC enabled, you must have admin access to install the Magalix Agent. To gain admin rights you'll need to execute the following command.

$ kubectl create clusterrolebinding username-cluster-admin-binding  --clusterrole=cluster-admin --user=username@company.com

The username can be case sensitive in some IAM systems, GCP for example. Make sure you are using the right case when you create the ClusterRoleBinding, otherwise the user won't be authorized to deploy the Agent.

Using The Secure URL

In the middle of the page of the define cluster wizard, you'll see a URL and a copy icon to the left. To install the Agent, copy the command and paste it into your terminal. If successful, you'll see an output similar to the one below.

$ kubectl apply -f https://dev1.console.magalix.com/cluster-deployment/6aa6689b-252b-4df0-bf1e-46c1436cf551/2018-09-10T19:58:06Z/5d7e8540597bacf2e26d76dcd1bce1b679cf36676112218d134f8dd2da60a6e4/deployment.ya


Using The Agent YAML

The review page of the "Connect Cluster" wizard provides a "Download" button which you can use to locally save the YAML of the Magalix Agent. To download the YAML, expand the panel and click the blue download button on the left. You can also download the YAML from the cluster dashboard showing after you hit finish.

To install the Agent type the following command in your terminal.

$ Kubectl apply -f \fileName.yaml


Validate The Agent Deployment

To validate if the Magalix Agent pod has been successfully installed, use the following command. You should see something like magalix-agent-865b6d9ffb-n4v9w in the listed pods

$ kubectl get pods --namespace kube-system
NAME                                                READY     STATUS    RESTARTS   AGE
event-exporter-v0.1.8-599c8775b7-fprtf              2/2       Running   0          1d
fluentd-gcp-v2.0.9-vhg24                            2/2       Running   0          1d
heapster-v1.4.3-d74857f95-8tz25                     3/3       Running   0          1d
kube-dns-778977457c-6vkdf                           3/3       Running   0          1d
kube-dns-autoscaler-7db47cb9b7-w4q49                1/1       Running   0          1d
kube-proxy-gke-sandbox-default-pool-a57643f1-s22p   1/1       Running   0          1d
kubernetes-dashboard-6bb875b5bc-8jzxn               1/1       Running   0          1d
l7-default-backend-6497bcdb4d-4z8g5                 1/1       Running   0          1d
magalix-agent-865b6d9ffb-n4v9w                      1/1       Running   1          1d
tiller-deploy-dccdb6fd9-r4b4f                       1/1       Running   0          1d


Running the same connection command on multiple clusters will generate unexpected behavior and recommendations, which will eventually mess with your dashboard’s accuracy. Define a new cluster and run its command if you have more than one cluster to connect.