Docs Menu

Docs Home → View & Analyze Data → MongoDB Compass

Command Line Options

On this page

  • Definition
  • Compass Executable Location
  • Syntax
  • Options
  • Learn More

You can customize MongoDB Compass using command line options.

Definition

You can start MongoDB Compass and set configuration options from the command line. When you use the command line to set configuration options, the options are set at startup. Settings configured using command line options cannot be modified on the Compass interface.

Compass Executable Location

The name and location of the Compass executable varies by operating system.

Operating System
Executable Name
Location
Linux
mongodb-compass
The installer installs it in the /usr/bin directory.
Windows
MongoDBCompass.exe
The installer installs it in a folder you pick during the installation process.
MacOS
MongoDB Compass

The installer installs it under the Applications folder:

/Applications/MongoDB\ Compass.app/Contents/MacOS/MongoDB\ Compass

Syntax

Use the following syntax to start MongoDB Compass and set a configuration option:

<path-to-Compass-executable> --<option>

Options

Command Line Only

These options can only be set on the command line. These options cannot be set in the Settings panel or the Compass configuration file.

Setting
Definition
--exportConnections
Export favorite connections.
--file <file>
Specify a file containing a list of connections. These connections are automatically available once MongoDB Compass starts.
--help
Show MongoDB Compass options.
--importConnections
Import favorite connections.
--passphrase

Specify a passphrase to encrypt the exported favorite connections output file.

Specify a passphrase to decrypt the imported favorite connections file.

--version
Show MongoDB Compass version.

General Settings

These options can be set on the command line, in a configuration file, or in the Settings panel. Setting an option on the command line overrides the value in the Settings panel.

Setting
Definition
--autoUpdates
Enable automatic updates. Use --no-autoUpdates to disable automatic updates.
--enableFeedbackPanel
Enable the feedback panel. Use --no-enableFeedbackPanel to disable automatic updates.
--enableDevTools

Enable Chrome DevTools in Compass.

To learn more, see Toggle Chrome DevTools.

--enableMaps
Allow MongoDB Compass to make requests to a 3rd party mapping service. Use --no-enableMaps to disable mapping requests.
--enableShell

Enable or disable the embedded MongoDB Shell on Compass.

To learn more, see Disable the Embedded MongoDB Shell.

--forceConnectionOptions

Assign connection option values for when you connect to your MongoDB deployment through Compass. These connection options cannot be overridden by connections from the Compass interface or a command line connection string.

To learn more, see Specify Read Preference and Tags.

--installURLHandlers

Register Compass as a handler for mongodb:// and mongodb+srv:// URLs.

If Install Compass as URL Protocol Handler is enabled, you can open Compass by navigating to a mongodb:// or mongodb+srv:// URL in your internet browser.

Available on macOS and Windows.

--maxTimeMS
Specify an upper time limit for all Compass database operations.
--networkTraffic

Configure MongoDB Compass to only allow outgoing network operations to connect to the database.

To learn more, see Block Outgoing Network Connections.

--protectConnectionStrings

Sets all connection strings as read-only. Passwords in connection strings display as *****.

If protectConnctionStrings is enabled, Compass disables the Edit connection string option and hides the Edit connection string toggle.

To learn more, see Hide Credentials in Your Connection String.

--readOnly

Prevent users from performing write operations to your MongoDB deployment through Compass.

To learn more, see Restrict Write Operations to MongoDB.

--showKerberosPasswordField

Show or hide the Kerberos password field on the Compass connection form.

To learn more, see Display the Kerberos Password Field.

--theme
Specify the MongoDB Compass UI theme. The supported themes are DARK, LIGHT, and OS_THEME.
--trackUsageStatistics
Enable sending usage statistics. Use --no-trackUsageStatistics to disable sending usage statistics.

Note

To view all available Compass configuration options, run the following command in the folder containing your MongoDB Compass executable:

<path-to-Compass-executable> --help

Learn More

← Interface Settings
Configuration File Settings →

On this page