# MongoDB (Beta)

*MongoDB support is currently **in beta**. Please raise any issues you encounter via the chat bubble in the bottom-right of the site, and we'll be happy to help.*

***

### Overview

Our MongoDB integration allows you to import your data; allowing you to clean, transform, and ask questions via Chat Explore.

{% hint style="danger" %}
You must allow network traffic from the public IP address `54.197.189.139` in order to allow Akkio to access your data.
{% endhint %}

### Importing Data

To import data, first create a new project.

<figure><img src="https://71333621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUiovvmaDi_ad2DYdZ4%2Fuploads%2FAFNajru139bRuMqAwQcV%2Fimage%20(28).webp?alt=media&#x26;token=c91194e1-80c1-48ca-8b5a-3c2ab2b741c5" alt=""><figcaption><p>Create a new project from the homepage.</p></figcaption></figure>

Select the MongoDB button.

<figure><img src="https://71333621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUiovvmaDi_ad2DYdZ4%2Fuploads%2F9lzNYZG00Kdj2g1f2sIL%2Fimage%20(53).webp?alt=media&#x26;token=73dc8e1c-972e-4501-8b57-e4f82fbba0e8" alt="" width="447"><figcaption></figcaption></figure>

Click "Connect Dataset" to add a new dataset.

<figure><img src="https://71333621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUiovvmaDi_ad2DYdZ4%2Fuploads%2FaMoKobilXXn5zX9xTdeK%2Fimage.png?alt=media&#x26;token=6acc6e13-a3cd-4503-8033-9fb3092a2de9" alt=""><figcaption></figcaption></figure>

Enter connection details for your database.

<figure><img src="https://71333621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUiovvmaDi_ad2DYdZ4%2Fuploads%2FV4bQFBffiytiCemLYGLv%2Fimage%20(54).webp?alt=media&#x26;token=10f3aa93-5bfd-4146-8de8-f289020dff0d" alt="" width="520"><figcaption></figcaption></figure>

<figure><img src="https://71333621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUiovvmaDi_ad2DYdZ4%2Fuploads%2Fhm6p0YM3VHy7PrCWj9bD%2Fimage%20(55).webp?alt=media&#x26;token=888ce87a-b8c9-4471-bbb0-8831422a4d8d" alt="" width="520"><figcaption></figcaption></figure>

**Make sure your security settings allow us to connect to your database.** You'll need to add our IP Address, `54.197.189.139`, to your security settings so we can connect and pull your data in.

To pull in your data, input the following:

* **Hostname:** The hostname of your MongoDB instance (this looks like the URL).
* **Database** The name of the database within your MongoDB instance that your table is inside.&#x20;
* **Username/Password:** Credentials for the database user to authenticate. This user must have read permissions for a table to import and write permissions to deploy.

When complete, hit continue.

Next enter **Table Name:** The name of the table to pull from.

<figure><img src="https://71333621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUiovvmaDi_ad2DYdZ4%2Fuploads%2FtUO29yILfNvKtSxwOGY9%2Fimage%20(56).webp?alt=media&#x26;token=fb26f1cb-c1dd-4dd3-bbe2-2c0a4116e4f1" alt="" width="525"><figcaption></figcaption></figure>

This will run a connection test; if successful, you'll see the data loading screen. Data will take some time to import based on table size.

<figure><img src="https://71333621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUiovvmaDi_ad2DYdZ4%2Fuploads%2FqH9fkPU3TonkjoUKOyt0%2Fimage.png?alt=media&#x26;token=75013bf2-6393-4f61-a165-5136a8803c27" alt=""><figcaption></figcaption></figure>

Once your data is done importing, you'll see it populate onto the screen.

<figure><img src="https://71333621-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MUiovvmaDi_ad2DYdZ4%2Fuploads%2FT2QiQwdkQMllWZVvNLqc%2Fimage.png?alt=media&#x26;token=dc40fca7-9290-44df-b271-5a7e7bd2543a" alt=""><figcaption></figcaption></figure>

Now, your data is loaded into Akkio and will function normally. If this is your first time connecting data, take a look at [Prepare](https://docs.akkio.com/akkio-docs/prepare-your-data/prepare) to get started.
