Leaving the Cluster
- Last Updated: April 14, 2026
- 1 minute read
- MarkLogic Server
- Version 10.0
- Documentation
A host has to leave a cluster before being moved to another cluster. Leaving a cluster is also a way to switch a host from a single host environment to a multi-host environment or vice versa. 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. In a single-host environment, a host cannot leave a cluster because it will always have forests assigned to it.
To make a host leave a cluster, follow these steps:
-
Access the Admin Interface from any host in the cluster.
-
Click the Hosts icon in the left tree menu.
-
Click the name of the host that you want to remove from the cluster. The host configuration screen appears.
-
Click the Leave button.
-
Click OK to confirm leaving the cluster. The host restarts to load the new configuration.
-
Click OK to self-install initial databases and application servers. A prompt to join a cluster appears.
-
To join another cluster, enter the name of one of the hosts in that cluster and click OK. Otherwise, click Skip.
-
Set up an admin user name and password if prompted.
-
Log in with the admin user name and password if prompted. The Admin Interface appears.