# Getting Started

The instructions and how-to guides on this page illustrate how to install Immuta in your Kubernetes environment. If you are upgrading Immuta, navigate to the [Upgrade section](/2024.2/self-managed-deployment/upgrade-overview.md) instead.

## Prerequisites and requirements

* Use a supported version of Kubernetes.
* Use Helm 3.2.0 or newer (When using a Helm version older than 3.8.0, enable OCI experimental mode by exporting environment variable `HELM_EXPERIMENTAL_OCI=1`.)
* Deploy the services listed on the Deployment requirements guide. See the [recommendations table](/2024.2/self-managed-deployment/deployment-requirements.md#infrastructure-recommendations) for guidance for specific cloud providers.
* Grant [RBAC permissions](https://kubernetes.io/docs/reference/access-authn-authz/rbac/) to create Kubernetes resources in the cluster.

## Pull the Helm chart

Consult the [upgrade overview](/2024.2/self-managed-deployment/upgrade-overview.md) if unsure which Helm chart to use.

## ocir.immuta.com

{% hint style="warning" %}
**Helm chart availability**

The deprecated Immuta Helm chart (IHC) is not available from ocir.immuta.com.
{% endhint %}

Copy the snippet below and replace the placeholder text with the credentials provided to you by your Immuta support professional:

```shell
echo <token> | helm registry login --password-stdin --username <username> ocir.immuta.com
```

## Install Immuta

Immuta can be installed on any Kubernetes cluster. Select a guide below that corresponds to your Kubernetes distribution to install Immuta. If your distribution is not listed below (such as [K3s](https://k3s.io/) or [RKE2](https://docs.rke2.io/)), follow the generic installation instructions:

* [Managed public cloud](/2024.2/self-managed-deployment/install/managed-public-cloud.md): This guide includes instructions for
  * Amazon Elastic Kubernetes Service (EKS)
  * Google Kubernetes Engine (GKE)
  * Microsoft Azure Kubernetes Service (AKS)
* [Red Hat OpenShift](/2024.2/self-managed-deployment/install/red-hat-openshift.md)
* [Generic installation](/2024.2/self-managed-deployment/install/generic-installation.md)

## Configure Ingress

To complete your installation and access the Immuta application, [configure Ingress](/2024.2/self-managed-deployment/configure/ingress-configuration.md).

## Additional recommendations

The [configure section](/2024.2/self-managed-deployment/configure.md) includes guidance for various scenarios you may encounter during and post-deployment. Below are several guides from that section that most customers follow to complete their deployment of Immuta, but none of these is a requirement for the Immuta installation to work.

* [TLS configuration](/2024.2/self-managed-deployment/configure/tls-configuration.md): Secure your Ingress by specifying a Secret that contains a TLS private key and certificate.
* [Immuta in production](/2024.2/self-managed-deployment/configure/immuta-in-production.md): Follow these best practices for configuring your deployment for a production environment.
* [External cache configuration](/2024.2/self-managed-deployment/configure/external-cache-configuration.md): The Immuta Enterprise Helm chart manages its own Memcached deployment inside the cluster. However, you can opt to externalize the key-value cache post-installation.


---

# 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://documentation.immuta.com/2024.2/self-managed-deployment/getting-started.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.