Install ERPNext on Kubernetes

How to Install ERPNext on Kubernetes with Helm

This guide will walk you through the process of installing ERPNext using Helm, the Kubernetes package manager, ensuring a smooth and efficient setup.

Prerequisites

Before we begin, ensure you have the following tools installed and configured:

• Kubernetes - Installed locally or in a public cloud provider
• kubectl - Configured to communicate with your Kubernetes cluster
• Helm - For managing Kubernetes applications like ERPNext
• Kubernetes Ingress controller - For accessing the installation on a url

Step 1: Add the Helm chart repository

First, add the repository containing the ERPNext helm chart:

helm repo add frappe https://helm.erpnext.com
helm repo update
helm search repo erpnext

Step 2: Create a namespace (optional)

Isolating applications within Kubernetes namespaces is a good practice. To deploy ERPNext in its own namespace:

kubectl create namespace erpnext

Step 3: Install ERPNext using Helm

Now, you'll install ERPNext. The helm chart name is "erpnext":

helm install erpnext frappe/erpnext --namespace erpnext --create-namespace

Step 4: Verify the installation

After installation, verify that your ERPNext deployment is running smoothly:

kubectl get pods --namespace erpnext
kubectl get all --namespace erpnext

Step 5: Customize the ERPNext installation (optional)

This process may require customizing your deployment through a customized values.yaml file, which specifies configuration options.

helm install erpnext frappe/erpnext --values values.yaml --namespace erpnext

Step 6: Access ERPNext

Accessing ERPNext will depend on your chosen service configuration (LoadBalancer, NodePort, or Ingress). For Ingress access, ensure an Ingress controller is operational in your cluster.

Follow the instructions in the helm install notes, the output of Step 3.