# Connect to Amazon DocumentDB from DbVisualizer
<a name="connect-jdbc-DbVisualizer"></a>

**Topics**
+ [Adding the Amazon DocumentDB JDBC driver](#connect-jdbc-DbVisualizer-adddriver)
+ [Connecting to Amazon DocumentDB using DbVisualizer](#connect-jdbc-DbVisualizer-connect)

## Adding the Amazon DocumentDB JDBC driver
<a name="connect-jdbc-DbVisualizer-adddriver"></a>

To connect to Amazon DocumentDB from DbVisualizer you must first import the Amazon DocumentDB JDBC Driver

1. Start the DbVisualizer application and navigate to the menu path: **Tools > Driver Manager...**

1. Choose **\+** (or in the menu, select **Driver > Create Driver**).

1. Set **Name** to `DocumentDB`.

1. Set **URL Format** to `jdbc:documentdb://<host>[:port]/<database>[?option=value[&option=value[...]]]`

1. Choose the **folder** button and then select the Amazon DocumentDB JDBC driver JAR file and choose the **Open** button.

1. Verify that the **Driver Class** field is set to `software.amazon.documentdb.jdbc.DocumentDbDriver`. Your Driver Manager settings for **DocumentDB** should look like the following example.  
![Driver Settings interface in DbVisualizer with Amazon DocumentDB name, URL format, and driver class configurations inputted.](http://docs.aws.amazon.com/documentdb/latest/developerguide/images/jdbc/DbVisualizer-adddriver.jpg)

1. Close the dialog. The Amazon DocumentDB JDBC driver will be setup and ready to use.

## Connecting to Amazon DocumentDB using DbVisualizer
<a name="connect-jdbc-DbVisualizer-connect"></a>

Connect to Amazon DocumentDB Using DbVisualizer

1. If you are connecting from outside the Amazon DocumentDB cluster's VPC, ensure you have setup an SSH tunnel.

1. Choose **Database > Create Database Connection** from the top level menu.

1. Enter a descriptive name for the **Name** field.

1. Set **Driver (JDBC)** to the DocumentDB driver you created in the previous section.

1. Set **Database URL** to your JDBC connection string. 

   For example: `jdbc:documentdb://localhost:27017/database?tlsAllowInvalidHostnames=true`

1. Set **Database Userid** to your Amazon DocumentDB user ID.

1. Set **Database Password** to the corresponding password for the user ID.

   Your Database Connection dialog should look like the following dialog:  
![Database Connection interface with DocumentDB settings.](http://docs.aws.amazon.com/documentdb/latest/developerguide/images/jdbc/DbVisualizer-connect.jpg)

1. Choose **Connect**.