Docs Menu

Docs HomeMongoDB Connector for BI

Install BI Connector on macOS

On this page

  • Prerequisites
  • MongoDB User Permissions
  • Install the BI Connector


The MongoDB Connector for BI and associated utilities are compatible with all currently supported MongoDB server versions.

To set up MongoDB Connector for BI with a business intelligence tool such as Tableau, follow the steps on this page.

  • OpenSSL installed on your host.

To install OpenSSL via Homebrew, run the following command:

/usr/bin/ruby -e "$(curl -fsSL"
brew update
brew install openssl

If your MongoDB instance uses authentication, your BI Connector instance must also use authentication. The user that connects to MongoDB via the mongosqld program must have permission to read from all the namespaces you wish to sample data from.

For more details about MongoDB user permissions in BI Connector, see User Permissions for Cached Sampling.


Download the BI Connector from the MongoDB Download Center.

  1. Extract the downloaded .zip archive. Replace {SOURCE-PATH} with the path to the directory where you downloaded the .zip archive. Replace {DESTINATION-PATH} with the path to the directory where you want to extract the archive.

    unzip {SOURCE-PATH}/mongodb-bi-osx-x86_64-{version}.zip -d {DESTINATION-PATH}
  2. Change to the mongodb-bi-osx-x86_64-{version} directory. Replace {DESTINATION-PATH} with the path to the directory where you extracted the archive in the previous step.

    cd {DESTINATION-PATH}/mongodb-bi-osx-x86_64-{version}/
  3. Install the programs within the bin/ directory into a directory listed in your system PATH. If a prior version exists, overwrite the binaries.

    sudo install -m755 bin/mongo* /usr/local/bin/

New in version 2.9.

To help you get started, a sample mongosqld configuration file named example-mongosqld-config.yml is included with the installation package. To learn how to start BI Connector with a configuration file, refer to the mongosqld documentation section on the Configuration File.

You are now ready to launch the BI Connector. The following guide contains detailed information on BI Connector configuration, schema generation, and launch options:

Share Feedback
© 2023 MongoDB, Inc.


  • Careers
  • Investor Relations
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2023 MongoDB, Inc.