System Collections

On this page

Synopsis

MongoDB stores system information in collections that use the <database>.system.* namespace, which MongoDB reserves for internal use. Do not create collections that begin with system.

MongoDB also stores some additional instance-local metadata in the local database, specifically for replication purposes and in the config database for sessions information.

Collections

System collections include these collections stored in the admin database:

admin.system. roles

New in version 2.6.

The admin.system.roles collection stores custom roles that administrators create and assign to users to provide access to specific resources.

admin.system. users

Changed in version 2.6.

The admin.system.users collection stores the user’s authentication credentials as well as any roles assigned to the user. Users may define authorization roles in the admin.system.roles collection.

admin.system. version

New in version 2.6.

Stores the schema version of the user credential documents.

System collections also include these collections stored directly in each database:

<database>.system. namespaces

Deprecated since version 3.0: Access this data using listCollections.

The <database>.system.namespaces collection contains information about all of the database’s collections.

<database>.system. indexes

Deprecated since version 3.0: Access this data using listIndexes.

The <database>.system.indexes collection lists all the indexes in the database.

<database>.system. profile

The <database>.system.profile collection stores database profiling information. For information on profiling, see Database Profiling.

<database>.system. js

The <database>.system.js collection holds special JavaScript code for use in server side JavaScript. See Store a JavaScript Function on the Server for more information.