# Kubernetes (experimental)

> note: We are currently moving MOLGENIS to the cloud via Kubernetes. However, **this is NOT production ready**.

There are a few basic concepts you should know before you read this guide.

* [Kubernetes](https://kubernetes.io/docs/home/)
* [Helm](https://helm.sh/)
* [Rancher](https://rancher.com/what-is-rancher/overview/)

## Deployment

The architecture of MOLGENIS to run in Kubernetes is displayed in the following figure.

![MOLGENIS components](https://github.com/molgenis/molgenis/tree/70aed64f4ed836e67e9705d419b381dcd71b8b86/docs/images/install/molgenis_architecture_kubernetes.svg?raw=true)

### Helm

We use helm to deploy the MOLGENIS instance. We expose our charts on <https://helm.molgenis.org>. You can add it as your own helm repository and install it by executing the following command:

```bash
helm repo add molgenis https://helm.molgenis.org
helm repo update
helm install molgenis
```

### Rancher

For our own orchestration, we use Rancher. We support Rancher catalogs. Just like with helm you can add the catalog by adding the helm repo to your Rancher instance.

Our Rancher catalogs can be found here: <https://helm.molgenis.org>.

You can use the [rancher-cli](https://rancher.com/docs/rancher/v2.x/en/cli/) to deploy the app on Rancher:

`rancher app install molgenis`

### Documentation

For MOLGENIS chart documentation you can navigate [here](https://github.com/molgenis/molgenis-ops-helm/tree/master/charts/molgenis).

> note: You can find detailed documentation on the helm charts we expose [here](https://github.com/molgenis/molgenis-ops-helm).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://molgenis.gitbook.io/molgenis/8.1/for-system-administrators/guide-kubernetes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.