Adding nodes to clusters

Adding nodes to clusters

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

HTTP method and URI

POST /controller/addNode


This is a REST request made to a Couchbase cluster to add a server node to the cluster. A new node is add 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]"


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 admin:password \ \
  -d "hostname="


If successful, Couchbase Server responds:

HTTP/1.1 200 OK