Powered by Zoomin Software. For more details please contactZoomin

Install MarkLogic Server

Leaving a Cluster and Becoming a Single Host

  • Last Updated: April 21, 2026
  • 2 minute read
    • MarkLogic Server
    • Version 11.0
    • Documentation

If your host is currently in a cluster of multiple hosts, and you would like to leave the cluster and switch to a single host environment, then follow the steps in this section.

A host cannot leave a cluster if there are still forests assigned to it or if it has any foreign clusters associated with it. You must delete all forests assigned to the host and de-couple any clusters associated with a host before you can leave the cluster. However, if you delete only the configuration for a forest, then the forest data remains on the filesystem, allowing you to add the forest back to the host after changing the configuration. For instructions on adding a forest to a host, see Administrate MarkLogic Server.

To leave the cluster to which a host is connected, follow these steps:

  1. Run the Admin Interface from the host that you want to remove from the cluster.

  2. Click Hosts in the left menu tree. The Host Summary page appears.

  3. Click the name of the host that you want to remove from the cluster, either from the left menu tree or from the Host Summary page. The Host Configuration page appears:

    host1.png

    Note:

    The Leave button appears only if the Admin Interface is running from this host.

  4. Click Leave.

  5. Click OK to confirm leaving the cluster. The host restarts to load the new configuration.

  6. Follow the instructions in either Configuring a Single Host or the First Host in a Cluster or Configuring an Additional Host in a Cluster.

TitleResults for “How to create a CRG?”Also Available inAlert