Skip to main content
This guide assumes you have already provisioned your target infrastructure and satisfied the prerequisites outlined in the Requirements page.
Installing Domino can be broken down into two principal tasks:
  1. Filling out the configuration file.
  2. Creating the Domino custom resource.
If you are comfortable tackling all of these tasks in one workflow, you can go through the bootstrap command covered in Bootstrap a Domino Cluster. Otherwise, you can address each of these tasks in turn.
This guide is intended for use when you install Domino for the first time. If you are upgrading an existing Domino deployment or migrating an existing Domino cluster to use the Platform Operator, please see the Upgrade Domino guide.

​
Create the configuration file

  1. Get the $FLEETCOMMAND_AGENT_TAG for your target release from the releases page.
  2. Use environment variables to set some values used by ddlctl CLI. This simplifies the commands you’ll run while installing Domino components:
  3. Generate a configuration file:
    If you are creating a configuration file for a target cloud provider, refer to the specific guide for that provider to get the correct value for the --preset flag when running this subcommand. For data planes, these are also the data-plane and data-plane-eks presets.
  4. Running this command writes a configuration file to the current working directory with the name:

​
Populate the configuration file

To install a functional Domino cluster, you must update the generated configuration file with the appropriate values for your target environment. You can refer to the configuration reference pages for more details on the values you can set.
Changing the defaults in the generated configuration can affect the deployment. If you must adjust its parameters, contact a Domino representative.

​
Data Plane deployments

Domino now supports installing data planes with the operator. You should use the data-plane or data-plane-eks presets to generate an initial data plane configuration. For the full procedure, including per-cloud ingress and storage configuration, see Install a Data Plane. The primary difference between the default preset and the data-plane preset is the following stanza:
email_notifications, telemetry, blob_storage, internal_docker_registry, external_docker_registry and monitoring are omitted from the configuration. Additionally, storage_classes is optional on data plane installs. We recommend enabling the New Relic integration while updating the install configuration:
The New Relic integration enables Domino application monitoring via New Relic. This helps Domino monitor and proactively assist with platform infrastructure issues. Enabling the New Relic integration can reduce the time it takes to resolve support tickets.

​
Create the Domino custom resource

Once you are satisfied with the configuration file, you can create the Domino custom resource. This gets picked up by the Platform Operator which then handles the installation of all Domino components.
If you would prefer to just generate the Domino custom resource YAML, you can supply the --export flag and pipe the result to a file. When the installation completes successfully, you should see a message that says:

​
Dry runs

  1. If you would prefer to dry run the installation, you should modify the Domino custom resource to put it in dry run mode:
  2. In the domino-cluster.yaml file, modify the spec.agent.spec to put the operator in a dry run mode:
  3. Now apply the resource to the cluster:
Dry running an upgrade of Domino reports on the changes that are made to the Domino cluster compared to what is (or is not) already represented in the Helm manifests in Helm storage. Once you change dryRunMode back to "false" (or remove the field entirely), a reconciliation is triggered and the Domino cluster is installed.

​
Next steps

Last modified on September 3, 2026