# Connect From MongoDB Clients

The NoSQL protocol module allows a MariaDB server or cluster to execute transactions for applications using MongoDB client libraries, transparently converting MongoDB API calls into the equivalent SQL. The MariaDB responses are then converted into the format expected by the MongoDB® client library and application.

For detailed information on supported commands, see "[NoSQL Protocol Module](/docs/maxscale/reference/maxscale-protocols/maxscale-nosql-protocol-module.md)" in MariaDB MaxScale documentation.

{% hint style="info" %}
The feature is supported by MaxScale, the advanced proxy for MariaDB. MaxScale starts when using the MariaDB Cloud Replicated topology and will not function with a standalone MariaDB server.
{% endhint %}

## Enable Support for NoSQL

1. When [launching](/docs/mariadb-cloud/cloud-usage/launch-page.md) Mariadb Server With Replica(s), after defining the service name, expand the "Additional options" section.
2. Check the "Enable support for NoSQL" checkbox.

## Available Clients

Connect to the NoSQL interface using a MongoDB client library or compatible application. [Documentation on official MongoDB libraries](https://www.mongodb.com/docs/drivers/) is available from MongoDB.

[Documentation on installing `mongosh` (the MongoDB Shell)](https://www.mongodb.com/docs/mongodb-shell/install/) is available from MongoDB.

## Connection Parameters

From the Dashboard, the details needed to connect to your MariaDB Cloud service can be seen by clicking on the "CONNECT" button for the desired service.

The "NoSQL port" is the TCP port used to connect to the NoSQL interface.

The [firewall](/docs/mariadb-cloud/security/configuring-firewall.md) must be configured to allowlist the client's IP address or netblock before connections can occur.

See the "Connecting using Mongosh" section of the Connect page for an example `mongosh` command-line, authentication instructions, and instructions to change the default password.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mariadb.com/docs/mariadb-cloud/connecting-to-mariadb-cloud-dbs/connect-from-mongodb-clients.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
