This topic describes how to connect to a sharded cluster instance by using the mongo shell, which is a database management tool provided with MongoDB. You can install the mongo shell on your client or in an ECS instance.



  1. Log on to the ApsaraDB for MongoDB console.
  2. In the upper-left corner of the page, select the region where the target instance resides.
  3. In the left-side navigation pane, click Sharding Instances.
  4. Find the target instance and click its ID.
  5. In the left-side navigation pane, click Database Connection to obtain the connection addresses of a mongos.
    Connection addresses
  6. Connect to the sharded cluster instance from your client or ECS instance that has the mongo shell installed.
    mongo --host <mongos_host> -u <username> -p --authenticationDatabase <database>
    • <mongos_host>: the connection string of a mongos in the sharded cluster instance.
    • <username>: the username you use to log on to a database of the sharded cluster instance. The initial username is root. We recommend that you do not log on to a database as the root user in a production environment. You can create users and grant permissions to them as needed. For more information, see Manage MongoDB users though DMS.
    • <database>: the name of the authentication database. It is the database where the database user is created. If the username is root, enter admin.


    mongo --host s-bp********** -u root -p --authenticationDatabase admin
  7. When Enter password: is displayed, enter the password of the database user and press Enter. If you forget the password of the root user, you can reset it. For more information, see Set a password for a sharded cluster instance.
    Note The password you enter is not displayed.

Common connection scenarios