Contact Us

Install Helm Charts

The following document will guide you through the basic steps of installing Mach5 Search using Helm.


To access Mach5 containers and Helm charts, you will need a Google service account. If you do not have one, please create a new service account and download the key file locally.

Once you have a Google service account, please reach out to your Mach5 contact to allow Artifact Registry access for that service account.

  • Mach5 Helm registry authentication:

In order to pull the Mach5 Search Helm chart, the service account configured above will need to be authenticated with Mach5's Helm registry


  1. Pull the Mach5 Search Helm chart from Artifact Registry
$ helm pull oci://

If you need a specific version, then use the --version flag.

  1. Create a new namespace for Mach5 Search:
$ kubectl create namespace mach5
  1. Create a secret to allow access to the Mach5 Artifact Registry
$ kubectl create secret docker-registry artifact-registry
  --docker-email=<SERVICE ACCOUNT EMAIL>
  --docker-password="$(cat <SERVICE ACCOUNT JSON KEY FILE>)" --namespace mach5

Please note that the SERVICE ACCOUNT mentioned in the above command is the one that has been enabled for accessing the Mach5 Artifact Registry

  1. Update the default Kubernetes service account to use correct credentials while pulling images
$ kubectl patch serviceaccount default -p '{"imagePullSecrets": [{"name": "artifact-registry"}]}' --namespace mach5
  1. Create a local-values.yaml file

The contents of this file minimally be the following (with values populated appropriately for your environment):

  name: ""
  host: ""
  port: ""
  sslmode: ""
  user: ""
  password: ""

  projectid: ""
  datasetid: ""
  key: ""

  useGcpInstanceMetadata: "false"
  useGcpInstanceMetadata: "false"

Update the values of the keys under metadatadb with the PostgreSQL database credentials. The bigquery section should contain your access details to BigQuery.

Note that the bigquery.key value should be the JSON contents of the service account key file that has Read/Write privileges to BigQuery in the specified dataset. For example:

  key: |
    { "type": "service_account", ...

  1. Install the chart
$ helm install m5test mach5-search-<version>.tar.gz -f local-values.yaml

Verifying the installation

The charts expose an ingress route at the path /. Using a web browser, navigate to the ingress endpoint to access Mach5 Search Dashboards.

© 2021-2023 Mach5 Software, Inc. All rights reserved

When you visit or interact with our sites, services or tools, we or our authorised service providers may use cookies for storing information to help provide you with a better, faster and safer experience and for marketing purposes.