Skip to content

Manage Storage hosts

Starting from NebulaGraph 3.0.0, setting Storage hosts in the configuration files only registers the hosts on the Meta side, but does not add them into the cluster. You must run the ADD HOSTS statement to add the Storage hosts.


NebulaGraph Cloud clusters add Storage hosts automatically. Cloud users do not need to manually run ADD HOSTS.

Add Storage hosts

Add the Storage hosts to a NebulaGraph cluster.

ADD HOSTS <ip>:<port> [,<ip>:<port> ...];
ADD HOSTS "<hostname>":<port> [,"<hostname>":<port> ...];


  • To make sure the follow-up operations work as expected, wait for two heartbeat cycles, i.e., 20 seconds, and then run SHOW HOSTS to check whether the host is online.
  • Make sure that the IP address and port number are the same as those in the configuration file. For example, the default IP address and port number in standalone deployment are
  • When using a domain name, enclose it in quotation marks, for example, ADD HOSTS "foo-bar":9779.
  • Ensure that the storage host to be added is not used by any other cluster, otherwise, the storage adding operation will fail.

Drop Storage hosts

Delete the Storage hosts from cluster.


You can not delete an in-use Storage host directly. Delete the associated graph space before deleting the Storage host.

DROP HOSTS <ip>:<port> [,<ip>:<port> ...];
DROP HOSTS "<hostname>":<port> [,"<hostname>":<port> ...];

Last update: February 19, 2024