Removing a node

Use these instructions when you want to remove nodes to reduce the size of your cluster, not for replacing a dead node.

If you are not using Virtual nodes (vnodes), you must rebalance the cluster.


If the node is a DSEFS node, follow this alternative node removal procedure: Removing a DSEFS node.

Failure to follow the DSEFS procedure may result in data loss.


  • Check whether the node is up or down using nodetool status:

    The nodetool command shows the status of the node (UN=up, DN=down):

    ops nodetool status arrow 1
  • If the node is up, run nodetool decommission.

    This assigns the ranges that the node was responsible for to other nodes and replicates the data appropriately.

    To avoid excessive data streaming, make node topology changes one at a time.

    Use nodetool netstats to monitor the progress.

    Decommission does not shutdown the node, shutdown the node after decommission has completed.

  • If the node is down, choose the appropriate option:

  • If removenode fails, run nodetool assassinate.

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2024 DataStax | Privacy policy | Terms of use

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: +1 (650) 389-6000,