Docs Menu
Docs Home
MongoDB Manual
/ / /


On this page

  • Definition
  • Compatibility
  • Syntax
  • Example

Deprecated since version 5.0.

If you enabled auditing, an attempt to use the logout command will create an entry in the audit log.

This command will be removed in a future release.


This command was used when you could log in as multiple users on a single logical connection. Because this is no longer possible, running logout is no longer supported. Going forward, you can achieve the same results by closing your connection.

This command is available in deployments hosted in the following environments:

  • MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud


This command is supported in all MongoDB Atlas clusters. For information on all commands, see Unsupported Commands.

The command has the following syntax:

logout: 1


If you're not logged in and using authentication, logout has no effect.

Because MongoDB allows users defined in one database to have privileges on another database, you must call logout while using the same database context that you authenticated to.

If you authenticated to a database such as users or $external, you must issue logout against this database in order to successfully log out.


Use the use <database-name> helper in mongosh, or the following db.getSiblingDB() method in an interactive mongosh session or in mongosh shell scripts to change the db object:

db = db.getSiblingDB('<database-name>')

When you have set the database context and db object, you can use the logout to log out of database as in the following operation:

db.runCommand( { logout: 1 } )
← authenticate