MongoDb JDBC Driver

This article will explain what are JDBC drivers, how to download the MongoDb JDBC driver and how to connect to MongoDb using DbSchema Free Database Designer.

What are JDBC Drivers?

JDBC drivers are Java library files with the extension .jar used by all Java applications to connect to the database. Usually, they are provided by the same company which implemented the MongoDb software. DbSchema Tool already includes an MongoDb driver, which is automatically downloaded when you connect to MongoDb.

What is the JDBC URL?

Each JDBC driver is using a specific URL. The URL is a string (text) with a specific format, containing information about the host where the database is running, the port, username, database name, etc. The format is specific to each driver. Any wrong character in the URL may make the database connectivity fail, therefore we recommend installing DbSchema and try to get connected. Then you can find the right URL directly in the DbSchema connection dialog.

Open-Source MongoDb JDBC Driver

We open source our JDBC driver for MongoDb. DbSchema features for MongoDb are described here. The driver source code is accessible on GitHub.

The driver binaries can be downloaded as zip file, which you should uncompress.

Download JDBC Driver

Download the zip, unpack and include the jar files in your classpath. The driver is compatible with Java 8. for any issues with the driver, you can write to us.

For accessing the driver source code please visit the GitHub repository:

Driver Source Code

The driver is written on top of the native MongoDb Java driver.

The driver URL is the same as in the MongoDb documentation.
Example :


The URL allows connecting to multiple databases. In DbSchema you can set this by choosing 'Custom URL' in the connection editor and entering the URL as string. For URL details check the MongoDb documentation.

MongoDb Atlas

Create an account by MongoDb Atlas and login. There you have an option to connect which will provide the URI. In the DbSchema Connection Dialog use manual URL configuration. On the same connection page you have also a link to change a user password in the database.


Connect to MongoDb using DbSchema Free Edition

Installing DbSchema Free edition will help to test the database connectivity and the JDBC driver URL.

Free Download DbSchema

When the download finished please follow this steps:

  1. 1 Select an Alias for your database connection. This will be the name of this specific connection to the database.
  2. 2 Select 'MongoDb' from the list of DBMS (Database Management Systems).
  3. 3 The driver for your database will be automatically downloaded for you in the folder
    • C:\Users\YourUser\.DbSchema\drivers\MongoDb (Windows) or
    • /Users/YourUser/.DbSchema/drivers/MongoDb (Linux and MacOS).
    Each database can have multiple connection and authentication methods. Switch to a different method from the dropdown menu.
Choose database and alias
  1. 4

    There are two tabs you can use to connect. 'Compose URL' will ask for the host, port, username, etc., and will create the JDBC URL for you.

    The 'Edit URL' will let you directly enter the JDBC URL.

    You can use the first tab to connect, and then see the created URL in the second tab.

Compose URL Tab Edit URL Tab
  1. 5 If connectivity succeeds, you should get your first DbSchema project and first diagrams.
Database Diagram

Connectivity Troubleshooting

If you get problems connecting to the database, please remember :
  • Press the ping button in the connection dialog to make sure the host and port are reachable.
  • Enable Remote connections as they are not always enabled by default. This may require configuration changes.
  • Windows Firewall may block the communication. You may need to reconfigure or disable it.
  • Check the driver version is compatible with the database software. It may be that DbSchema provided a JDBC driver is not the latest version. Please inform us in this case.
Further connectivity tips can be found on the MongoDb Connectivity Tips page.