> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hellocobi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Connect your database to start exploring your data with Cobi

## Overview

Data Connectors allow you to link your existing database directly to Cobi, enabling the Data Assistant to query and analyze your data in real-time.

<Info>
  All database connections are **read-only**. Cobi will never modify your data.
</Info>

## Supported Databases

Cobi currently supports the following database types:

* [**PostgreSQL**](/platform/data-connectors/postgresql) (versions 12 and above)
* [**MySQL**](/platform/data-connectors/mysql) (version 8.0 and above)
* [**MongoDB**](/platform/data-connectors/mongodb) (Atlas via SRV connection strings and self-hosted instances)

## Connecting Your Database

<Steps>
  <Step title="Open Developer Settings">
    Navigate to the **Developer** section in the sidebar, then select **Data Connectors**.
  </Step>

  <Step title="Add New Connection">
    Click the **Add Data Source** button to open the connection form.
  </Step>

  <Step title="Enter Connection Details">
    Fill in your database credentials:

    | Field               | Description                                                                       |
    | ------------------- | --------------------------------------------------------------------------------- |
    | **Connection Name** | A friendly name to identify this data source (e.g., "Production DB", "Analytics") |
    | **Host**            | Your database server address (e.g., `db.example.com` or an IP address)            |
    | **Port**            | The database port (default: `5432` for PostgreSQL)                                |
    | **Database Name**   | The name of the specific database to connect to                                   |
    | **Username**        | Database user with read access                                                    |
    | **Password**        | Password for the database user                                                    |
  </Step>

  <Step title="Test Connection">
    Click **Test Connection** to verify your credentials. Cobi will attempt to connect and confirm access.
  </Step>

  <Step title="Save Connection">
    Once the test succeeds, click **Save Changes** to store your connection.
  </Step>
</Steps>

{/* <Frame>
<img src="/images/platform/data-connector-form.png" alt="Data Connector Form" />
</Frame> */}

## Network Configuration

### IP Allowlisting

If your database is behind a firewall, you'll need to allowlist Cobi's IP addresses:

```
xx.xx.xxx.xx
xx.xx.xxx.xx
```

<Note>
  Contact [support@hellocobi.com](mailto:support@hellocobi.com) to get the IP addresses for your region.
</Note>

### Using SSH Tunnels

For databases that aren't publicly accessible, we recommend setting up an SSH tunnel or using a bastion host. Contact our support team for guidance on secure connection options.

## Managing Connections

### Edit a Connection

To update connection details:

1. Go to **Developer** > **Data Connectors**
2. Click on the connection you want to edit
3. Update the fields as needed
4. Click **Test Connection** to verify, then **Save Changes**

### Delete a Connection

To remove a data source:

1. Go to **Developer** > **Data Connectors**
2. Click on the connection
3. Click **Delete Connection**

<Warning>
  Deleting a connection will remove all learned information and custom instructions associated with that data source.
</Warning>

## Next Steps

Once your database is connected:

* Add [Custom Instructions](/platform/custom-instructions) to help Cobi understand your data
* Start a conversation with the Data Assistant to explore your data