Navigation

    FAQ

    Compass Isolated Edition restricts network requests to only the MongoDB server chosen on the Connect screen. All other outbound connections are not permitted in this edition, meaning no additional firewall configuration is required when running Compass Isolated Edition.

    Testing has shown that MongoDB Compass has minimal impact in prototype deployments, though additional performance testing and monitoring is in progress.

    You should only execute queries that are indexed appropriately in the database to avoid scanning the entire collection.

    MongoDB Compass stores and retrieves sensitive data such as passwords using a credentials API specific to the operating system running Compass. The credentials API securely handles sensitive information by encrypting and protecting access to your data.

    MongoDB Compass stores the following data using the credentials API:

    • MongoDB server passwords,
    • SSH passwords for tunneling,
    • TLS /SSL passphrases

    MongoDB Compass utilizes a node.js native add-on, Keytar, to communicate with and store data in the operating system's credentials API. For more information on how Keytar operates and the specific APIs it accesses, refer to the Keytar Github documentation.

    Starting in MongoDB Compass 1.19, Compass displays a warning message when connected to non-genuine MongoDB instances as these instances may behave differently from the official MongoDB instances; e.g. missing or incomplete features, different feature behaviors, etc.

    As a precaution, Compass aborts long running queries to prevent excessive querying on your database.

    All queries that Compass sends to your MongoDB instance have a timeout flag set which automatically aborts a request if it takes longer than the specified timeout. This timeout is currently set to 10 seconds. If sampling on the database takes longer, Compass will notify you about the timeout and give you the options of (a) retrying with a longer timeout (60 seconds) or (b) running a different query.

    Info With Circle IconCreated with Sketch.Note

    Sampling time may be affected by a number of factors, like load on the server, number of documents and existence of a suitable index for your query.

    It is recommended that you only increase the sampling timeout if you are not connected to a production instance, as this may negatively affect the performance and response time of your database.

    If the database returns documents faster than the specified timeout (10 or 60 seconds), but the schema analysis of the documents takes longer than expected (due to complex, large documents), Compass gives you the option to abort the analysis step and show the partial results.

    If you can connect to your MongoDB instance using MongoDB Compass but some features do not work as expected, your system firewall may be blocking network requests required by MongoDB Compass. MongoDB Compass features which require incoming connections from external sources include:

    • Third party mapping services
    • Intercom
    • Bugsnag for error reporting

    To fix this issue, configure your system firewall to allow incoming connections for MongoDB Compass. Ensure ports 80 and 443 are open between MongoDB Compass and the host for the MongoDB Instance to which Compass connects.

    Compass Isolated Edition restricts network requests to only the MongoDB server chosen on the Connect screen. All other outbound connections are not permitted in this edition, meaning no additional firewall configuration is required when running Compass Isolated Edition.

    To view and modify your MongoDB Compass privacy settings, from the top-level menu click Help, then Privacy Settings.

    The privacy settings dialog allows you to toggle various MongoDB Compass settings such as enabling crash reports and automatic updates. See the following screenshot for all available privacy settings options:

    /images/compass/privacy-settings.png
    Info With Circle IconCreated with Sketch.Note

    Crash reports and automatic updates are not available in Compass Isolated Edition.

    You can enable geographic visualizations in MongoDB Compass in your privacy settings. When Enable Geographic Visualizations is selected, MongoDB Compass is allowed to make requests to a third-party mapping service.

    Info With Circle IconCreated with Sketch.Note

    Third party mapping services are not available in Compass Isolated Edition.

    Give Feedback