Navigation

Download and Install Compass

Select your operating system:

    Software Requirements

    Compass requires:

    • 64-bit version of Microsoft Windows 7 or later.

    • MongoDB 3.6 or later.

    • Microsoft .NET Framework version 4.5 or later.

      The Compass installer prompts you to install the minimum required version of the .NET framework if it is not already installed on your system.

    Compass requires:

    • 64-bit version of macOS 10.12 or later.
    • MongoDB 3.6 or later.

    Compass requires:

    • 64-bit version of Ubuntu 14.04 or later.
    • MongoDB 3.6 or later.

    Compass requires:

    • 64-bit version of RHEL 7+ or later.
    • MongoDB 3.6 or later.

    Download Compass

    To download Compass, you can use your preferred web browser.

    1. Open the downloads page.
    2. Select the installer you prefer. The MongoDB Compass installer is available as a .exe or .msi package or a .zip archive.
    3. Download the latest version of MongoDB Compass for Windows.
    1. Open the downloads page.
    2. Download the latest version of MongoDB Compass for macOS. The MongoDB Compass installer is a .dmg disk image.
    1. Open the downloads page.
    2. Download the latest version of MongoDB Compass for Ubuntu. The MongoDB Compass installer is a .deb package.
    1. Open the downloads page.
    2. Download the latest version of MongoDB Compass for Red Hat Enterprise Linux. The MongoDB Compass installer is a .rpm package.

    Install Compass

    1. Double-click the installer file.
    2. Follow the prompts to install Compass. You can select the destination of the Compass installation.
    3. Once installed, Compass launches and prompts you to configure privacy settings and specify update preferences.
    1. Once you have downloaded Compass, double-click on the .dmg file to open the disk image within the macOS Finder.

    2. Drag the MongoDB Compass application to your Applications folder.

      ../_images/osx-install-dialog.png
    3. Eject the disk image.

    4. From the Applications folder, double-click on the Compass icon to start the application.

    5. Allow macOS to trust Compass. If you receive a security error when starting Compass indicating that the developer could not be identified or verified, perform the following actions to allow Compass to run:

      1. Open System Preferences.
      2. Select the Security and Privacy pane.
      3. Under the General tab, click the button to the right of the message about Compass, labelled either Open Anyway or Allow Anyway depending on your version of macOS.
      4. If necessary, re-open Compass.
    6. When you open MongoDB Compass for the first time, you may receive a notice stating that it is an application downloaded from the internet, requiring you to confirm you want to open it. Click Open to continue and launch Compass.

    Note

    Depending on your system’s security settings, you may have to modify your system settings to grant Compass permissions to run. You may be prompted to enter your system password before launching Compass.

    1. Double-click on the .deb package icon to start installation.

    2. Click Install.

      ../_images/install-ubuntu.png
    3. Once installed, launch Compass from your Applications folder.

    4. Start Compass:

      mongodb-compass
      
    1. Install Compass:

      sudo yum install mongodb-compass-1.21.2.x86_64.rpm
      
    2. Start Compass:

      mongodb-compass