Skip to main content
Use MongoDB Database Tools (mongorestore) and mongosh. The published archive contains BSON dump files with metadata; it is not a JSON import file.
These instructions use v5.2.0-export.1, published 3 November 2026. Its core tables contain 250 countries, 5,327 states and 156,169 city records. API data and installed package snapshots can differ. Check the latest release before choosing another version.

Download and extract

The dump is under mongodb-dump/world/. Inspect the files before restoring:

Restore into a new database

Choose an empty destination such as csc_world. Adjust the URI and authentication options for your server. Confirm the destination has no collections before restoring.
The namespace options restore the source world collections into csc_world. Preserve existing databases and investigate any restore error before retrying. For a remote server, use authenticated access and the connection settings required by that server.

Verify the restore

The pinned release lists 250 countries, 5,327 states and 156,169 city records. Inspect an individual document and its fields before writing application queries:

Troubleshooting

  • BSON dumps are restored with mongorestore. MongoDB Compass JSON import and mongoimport require a different file format.
  • Use mongosh for shell commands; the older mongo shell is not required.
  • Check the namespace mapping if collections appear under an unexpected database name.
  • Back up existing data before replacement. Review the release and its notices before distribution.
See the mongorestore reference and mongosh documentation for version compatibility, authentication and backups.