Docs Menu

Docs HomeMongoDB Manual


On this page

  • Definition
  • Behavior

Removes the member described by the hostname parameter from the current replica set. This function will disconnect the shell briefly and forces a reconnection as the replica set renegotiates which member will be primary. As a result, the shell will display an error even if this command succeeds.

The rs.remove() method has the following parameter:

The hostname of a system in the replica set.


Before running the rs.remove() operation, it is good practice to shut down the replica set member that you are removing.

By default, replica set members wait for 5 minutes before dropping connections to the removed member. In sharded replica sets, you can modify this timeout using the ShardingTaskExecutorPoolHostTimeoutMS server parameter.

New in version 4.2: To immediately drop all outgoing connections from the replica set to the removed member, run the dropConnections administrative command on each remaining member on the replica set:

"dropConnections" : 1,
"hostAndPort" : [

Replace <hostname> with the hostname of the removed member and <port> with the port the mongod listened on.

←  rs.reconfigForPSASet()rs.status() →

On this page

Share Feedback
© 2023 MongoDB, Inc.


  • Careers
  • Investor Relations
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2023 MongoDB, Inc.