Navigation

Download and Install Compass

    Software Requirements

    Compass requires:

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

    • MongoDB 3.0 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.

    • 64-bit version of macOS 10.10 or later.
    • MongoDB 3.0 or later.
    • 64-bit version of Ubuntu 14.04 or later.
    • MongoDB 3.0 or later.
    • 64-bit version of RHEL 7+ or later.
    • MongoDB 3.0 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. After you start the application, you see the following dialog:

      ../_images/application-downloaded-internet.png
    6. 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.17.0.x86_64.rpm
      
    2. Start Compass:

      mongodb-compass