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.

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.

Procedure

  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/MongoDB Compass Community
    Windows %APPDATA%/MongoDB Compass Community
    Linux

    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.