Adding Nodes to Clusters

Adding Nodes to Clusters

Nodes are added to clusters with the POST /controller/addNode HTTP method and URI.


This is a REST request made to a Couchbase Server cluster to add a server node to the cluster with a service: kv (data), index or n1ql (query). If you add a node with no services specified, the kv (the Data Service) will be enabled by default. A new node is added with the RESTful endpoint server_ip:port/controller/addNode. The administrative username and password parameters are required.

curl -u [admin]:[password]
  -d hostname=[IPaddress] user=[admin] password=[password] services=[kv|index|n1ql|fts]

After adding a node to the cluster, remember to rebalance the cluster. See Rebalancing Nodes for details.

HTTP method and URI

POST /controller/addNode


The following example request adds a server node,, to the cluster at The POST method, controller/addNode, IP address for the new server, and administrative credentials are provided. Since the POST method is the default, it is not required in the request.

curl -u Administrator:password \ \
  -d 'hostname='


If successful, Couchbase Server responds:

HTTP/1.1 200 OK