Skip to content

Complete preparatory procedure for first time installation of Volt MX Go


This is only applicable when you install Volt MX Go to a development or test only environment.

The following procedure must be performed post installation of K3s or Rancher Desktop, and before the download of the Domino REST API Helm chart and Volt MX Go Foundry installation.


If you deployed Kubernetes using Rancher Desktop, use an Ubuntu terminal session to run all the commands in this section and the other subsequent sections. To access the Ubuntu terminal, enter "Ubuntu" in the Windows search box and select the Ubuntu for Windows App. An Ubuntu terminal session opens with your home directory set as your current directory.

1. Configure Helm to pull from HCL Container Repository

The procedure sets up Helm with the details necessary to authenticate with the HCL Container Repository. You will need your email and authentication token used with the HCL Container Repository.

  • Run the following command to set up Helm:

    helm repo add hclcr --username <your hclcr username> --password <your hclcr password>


    helm repo add hclcr --username --password xx3ds2w


    Use the CLI secret value you saved from obtaining authentication token from HCL Container Repository as your authentication token or password.

If you get an error message similar to the following:

Error: looks like is not a valid chart repository or cannot be reached: failed to fetch : 401 Unauthorized

Most likely, you haven't specified your username or authentication token correctly. Make sure the case and content matches exactly what's listed on the HCL Container Repository site and retry.

2. Create a namespace for MXGO

Run the following commands to create a namespace and set the current context to mxgo:

kubectl create namespace mxgo
kubectl config set-context --current --namespace=mxgo


You must run the kubectl config set-context --current --namespace=mxgo command to set the current namespace context after each restart of Windows or Rancher Desktop.

3. Ensure Foundry Hostnames are resolvable

You must ensure the url used to access Volt MX Go Foundry and Domino REST API are resolvable by all systems that will be accessing it including Kubernetes and any browsers that you use. This can be done by adding DNS host names and IP addresses to your corporate DNS configuration, or by modifying the hosts file for all systems.

In the examples that follow we're going to use these hostnames as examples: - used to access Domino REST API. - used to access the Domino REST API Management interface. - used to access HCL Volt MX Go Foundry

You can either provide your own hostnames, or use these example names. Either the name to IP address mapping must be made in your DNS configuration, or you must modify your system hosts file. Further documentation here assumes you aren't using a DNS system and configuration and are therefore modifying local hosts file entries.


Obtain your machine's IP ADDRESS as you will need it in the following step.

Add the hostnames that you have chosen to use in your /etc/hosts file together with your IP ADDRESS and dns domain name. As an example:


If you will be accessing this deployment from other remote machines, you need to apply this same /etc/hosts file change on those machines as well.

For K3s only

  1. Run the following command to make these name/IP address matches available within the Kubernetes:

    kubectl edit configmap -n kube-system coredns
  2. Locate the segment that looks like the following:

        import /etc/coredns/custom/*.server
      NodeHosts: |
    kind: ConfigMap
  3. Before the line that starts with kind: ConfigMap, add a new line that uses the same IP address, but adds the hostnames you have chosen to use. When done, the segment of the file looks like the following code, but with your IP address and your own hostname. The previously hard-coded values are shown in this example:

        import /etc/coredns/custom/*.server
      NodeHosts: |
    kind: ConfigMap
  4. Save the file and exit the editor.

  5. Run the following command to force the restart of the coredns pod:

    kubectl delete pod -n kube-system -l k8s-app=kube-dns

For Rancher Desktop only

You must restart Rancher Desktop:

  1. Select FileExit to close the current session.
  2. Open a new session by opening Rancher Desktop via the desktop icon.


You must run the kubectl config set-context --current --namespace=mxgo command to set the current namespace context after each restart of Windows or Rancher Desktop.

4. Create a temp directory for the charts

Run the following commands to create a temp directory for the charts and make it the current directory:

mkdir ~/mxgo
cd ~/mxgo

5. Install wget and curl into your Linux environment

Use a search engine, such as Google, to search for instructions on installing wget and curl to the Linux environment that you are using if they're not already installed.

Next step

Proceed to Install Domino REST API.