Docs Menu

Docs HomeMongoDB Compass

Update MongoDB Compass

On this page

  • Manually Install the Latest Version of Compass
  • Enable Automatic Updates
  • Allow Keychain Access for Recent and Favorite Connections
  • Migrate to Compass from Compass Community

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.

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.


If you are running macOS Catalina or later, you may have to modify your system settings to grant Compass permission to run. For more information, see Install Compass.

You can enable automatic updates to the latest version of Compass in the Privacy section of the MongoDB Compass > 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.

On macOS systems, the first time that you update MongoDB Compass to version 1.20 or later, you will need to allow access to your system storage for each saved connection in Recents and Favorites.

When prompted for your keychain password, click Always Allow to prevent being prompted for your password in the future. This ensures MongoDB Compass has access to your saved connections when updating to new versions.

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.

MongoDB Compass stores saved connections, queries, and aggregation pipelines in folders in your file system. You can copy these folders to the corresponding folder for your upgraded Compass version to avoid recreating your saved data.

  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
    ~/Library/Application Support/MongoDB Compass Community
    %APPDATA%/MongoDB Compass Community

    One of either:

    • $XDG_CONFIG_HOME/MongoDB Compass Community/

    • ~/.config/MongoDB Compass Community

  3. Copy the following folders from your Compass Community edition folder to your fully-featured Compass folder:

    • Connections

    • FavoriteQueries

    • RecentQueries

    • SavedPipelines

    The fully-featured Compass folder is located in the same directory as your Compass Community edition folder.

  4. Launch the fully-featured edition of MongoDB Compass.


See also:

←  Download and Install CompassCapabilities of Compass Editions →
Share Feedback