Navigation

Upgrade MongoDB Compass

To ensure that you are using the latest Compass features and improvements, it is recommended to use the latest version of MongoDB Compass. To upgrade Compass, you can either manually install the latest version or enable automatic updates.

Manually Install the Latest Version of Compass

You can download and install the latest version of Compass from the MongoDB Downloads page at any time. Check the Software Requirements for your operating system and desired version of Compass to ensure Compass is compatible with your system. You do not need to uninstall previous versions of Compass to upgrade.

Enable Automatic Updates

You can enable automatic updates to the latest version of Compass on the Help > Privacy Settings dialog.

Privacy settings

MongoDB Compass does not install any updates without your explicit permission. Instead, Compass prompts you to upgrade when a new version is available.

Migrate to Compass from Compass Community

To migrate from Compass Community edition to the fully-featured edition of Compass and retain any saved data such as saved connection strings and favorite queries, you must migrate that data to your new edition of MongoDB Compass.

  1. Download the fully-featured edition of MongoDB Compass from the downloads page.

  2. Refer to the following table to see where your MongoDB Compass data is stored based on your operating system:

    Operating System Data Location
    macOS ~/Library/Application Support
    Windows %APPDATA%
    Linux $XDG_CONFIG_HOME or ~/.config
  3. Move the following folders from your Compass Community edition folder to your fully-featured Compass folder:

    • Connections
    • FavoriteQueries
    • RecentQueries
    • SavedPipelines