Install and Configure Mendix for Private Cloud Non-Interactive Mode

Last modified: April 24, 2025

Introduction

To support automation namespace installation and configuration we provide a non-interactive mode in our configuration tool.

Please see Download the Configuration Tool for information on how to download the configuration tool.

The following parameters may be used in the commands:

  • --namespace – a cluster namespace.
  • --clusterType – a cluster type openshift or generic.
  • --clusterMode – a cluster mode standalone or connected.
  • -i – the namespace id that is shown in the Installation tab of a namespace in the Private Cloud Portal.
  • -s – the namespace secret that is shown in the Installation tab of a namespace in the Private Cloud Portal.
  • --file – a file which contains the configuration for the namespace.

When using connected mode, you need to put namespace id and namespace secret as arguments. These parameters are used by the Mendix Gateway Agent to connect to the Private Cloud Portal. You can see these values in the installation command, as the -i and -s parameters, respectively.

Base Installation

To perform the base installation, use the following command:

./mxpc-cli base-install --namespace <namespace> -i <namespace-id> -s <namespace-secret> --clusterMode <cluster-mode> --clusterType <cluster-type>

The namespace-id and namespace-secret are only required when using Mendix for Private Cloud in connected mode.

Apply Configuration

To configure a standard namespace with a configuration file, use the following command:

./mxpc-cli apply-config -i <namespace-id> -s <namespace-secret> --file <config-file>

The namespace-id and namespace-secret are only required when using Mendix for Private Cloud in connected mode.

In case of standalone mode, the namespace-id and namespace-secret are not required. Instead, use the following command:

./mxpc-cli apply-config --file <config-file>

To generate the config file, follow the instructions described in Creating a Private Cloud Cluster. The mx_config_cli.yaml file is generated when you click Write YAML during the Review and Apply phase of configuring your namespace interactively.

Below is an example of a config file. The example is provided for reference only. To make sure that the config file captures all the values of the input fields used in your own app, you must generate your own mx_config_cli.yaml file.

namespace: my-namespace
cluster_mode: connected
mask:
  database_plan: true
  storage_plan: true
  ingress: true
  registry: true
  proxy: false
  custom_tls: false
database_plan:
  name: ephemeral-database
  type: ephemeral
storage_plan:
  name: ephemeral-storage
  type: ephemeral
ingress:
  type: openshift-route
  enable_tls: false
  k8s_ingress: null
  service: null
registry:
  type: openshift4

Upgrade Mendix Operator and Mendix Gateway Agent

To upgrade the versions of Mendix components in your namespace, use the following command:

./mxpc-cli upgrade-namespace --clusterType <cluster-type> --namespace <namespace>

Converting a Standard Namespace to Global Operator Namespace

To convert a standard namespace to a global operator namespace, perform the following steps:

./mxpc-cli global-operator convert-namespace -g <global-operator-main-namespace> -t <target-namespace>