A newer version of this documentation is available.

View Latest

Removing a Node

Full Administrators and Cluster Administrators can mark a node for removal from the Couchbase cluster.

If you remove a node that is running one of the services, it will have the following result:

  • Data service: reduced capacity to handle key/value workload.

  • Index service: index data loss on that node. This service does not support rebalance. When a node running the index service is removed or failed over, indexes that reside on the node are not moved to another node after rebalancing. These indexes are no longer available for queries and are dropped.

  • Query service: loss of query capability in that node.

Before you remove a node from the cluster, ensure that you have the capacity within the remaining nodes to handle the workload. Removing a node does not stop the node from servicing requests. Instead, it only marks the node as ready for removal from the cluster. You must perform a rebalance operation to complete the removal process. Once a node is removed, it is no longer part of the cluster and can be switched off, updated, or upgraded.

Prevent possible problems during online upgrades. Occasionally, during an online upgrade if all old nodes are removed from the cluster, clients may no longer know about any nodes and fail to connect. To prevent such problems, make sure that you provide one of the following solutions:

  • At least one of the original nodes is maintained in the cluster, and this node is listed in the client’s server configuration.

  • The client’s server configuration is appropriately updated to include at least one new node before the last old node is removed.

Remove Nodes via UI

Remove a node from the cluster from within the Server Nodes section of the Couchbase Web Console.

active servers
  1. Click Remove to mark the node for removal.

  2. After the node is removed, click on Rebalance.

Remove Nodes via REST API

Remove a node from a cluster with a curl command.

Curl request example:

curl -u admin:password -d otpNode=ns_1@ \

See also Removing Nodes from Clusters in the REST API reference.

Remove Nodes via CLI

You cannot mark a node for removal from the command-line without simultaneously initiating a rebalance operation.

The rebalance command accepts one or more --server-add or --server-remove options. This adds or removes the server from the cluster, and immediately initiates a rebalance operation.

To remove a node during a rebalance operation:

> couchbase-cli rebalance --cluster= \
          --user Administrator --password Password \