Skip to content
On this page

Getting Started with the Mappia Helm Chart

The Mappia Helm Chart is a Kubernetes package manager that allows you to define, install, and upgrade complex Kubernetes applications. This tutorial will guide you through the process of retreving the Mappia Helm Chart on your local machine and deploying it to your Kubernetes cluster.

Step 1: Install Helm

Before we can get started, we first need to install Helm on our local machine. Helm is the package manager for Kubernetes and allows you to easily deploy applications to your cluster. To install Helm, follow the instructions for your operating system at

Step 2: Login

Next, we need to login to the Mappia Registry in order to get access to the chart. You can retrieve your username and password from your account.

# For Helm <3.8, you need to enable OCI support.

helm registry login -u $YOUR_LICENSE_USERNAME

Step 3: Install the Mappia Helm Chart

Now that we have Helm installed and we can access the registry, we can install the Chart. To do this, run the following command:

helm install my-mappia oci://

This will install the Mappia Helm Chart and create a release named "my-mappia". You can change the release name to anything you like.

Step 4: Verify the Deployment

Once the Mappia Helm Chart has been installed, you can verify that the deployment was successful by running the following command:

kubectl get pods

This will show you a list of all the pods in your Kubernetes cluster. You should see something like:

Installer screen showing several Mappia pods running

Step 5: Access the Magento Installer

Now that the Mappia Helm Chart has been successfully deployed, you can access the Magento 2 application installer by running the following command:

kubectl get pods | grep "installer" | awk '{print $1}' | xargs -I{} kubectl exec -it {} sh

This will give you a shell onto the installer pod where you can run the installation commands for your Magento store.

Step 6: Disable installation mode.

helm upgrade my-mappia oci:// 
    \ --atomic 
    \ --set installer.enabled=false 


In this tutorial, we've covered the basic steps required to install and deploy the Mappia Helm Chart to your Kubernetes cluster. With Mappia, it's easy to manage Magento 2 applications and keep them up-to-date with new releases.