Menu Close
v0.35.3 / Administration Guide / Mongodb

Working with MongoDB in Metabase

This guide covers:

  • General connectivity concerns.
  • Connecting to a MongoDB Atlas cluster.

General connectivity concerns

  • Version 0.32.9 introduced an option to connect using DNS SRV, which is the recommended method for newer Atlas clusters.

  • Have you checked your cluster host whitelist? When testing a connection but seeing failure, have you tried setting the IP whitelist to This allows connections from any IP addresses. If you know the IP address(es) or CIDR block of clients, use that instead.

  • Are you using self-signed certificates? While Metabase doesn’t support providing a self-signed cert through the Metabase UI, you can still use the command line to configure this. Just copy the existing store and add the self-signed cert to it like this:

     cp /usr/lib/jvm/default-jvm/jre/lib/security/cacerts ./cacerts.jks
     keytool -import -alias cacert -storepass changeit -keystore cacerts.jks -file my-cert.pem

    Then, start Metabase using the store:

     java -jar metabase.jar

    Additional reference for configuring SSL with MongoDB for self-signed certs:


Connecting to a MongoDB Atlas cluster

To make sure you are using the correct connection configuration:

  1. Log into your Atlas cluster

  2. Select the cluster you want to connect to, and click “Connect”

    Your cluster screengrab

  3. Click “Connect Your Application”

    Connect screengrab

  4. Select “Java” and “3.6 or later”

    Java screengrab

  5. The resulting connection string has the relevant information to provide to Metabase’s Add a Database form for MongoDB.
  6. You will likely want to select the option Use DNS SRV, which newer Atlas clusters use by default.