MongoDB Atlas


This section outlines how to spin up MongoDB Cloud Databases and connect them with Neurelo. While we mention certain cloud providers here, it's important to note that Neurelo is designed to work seamlessly with supported MongoDB databases across any Cloud, Hybrid, On-Prem or Local deployments

Get Started with MongoDB Atlas

MongoDB Atlas ( is a managed multi-cloud database service. You can use Atlas free clusters for a small-scale development environment to host your data. Free clusters never expire, and provide access to a subset of Atlas features

MongoDB Atlas offers both a user interface (UI) and a command-line interface (CLI) for accessing its services. Be sure to click on the "Atlas UI" option when using the MongoDB documentation website.

Allowed inbound IP addresses: The default setting for Atlas Cloud services does not allow access from all IP ranges. Follow these instructions to manage access to specific IP ranges. You must add Neurelo's IPs to your allowed list on Atlas Cloud

Capture MongoDB connection details from Atlas UI

To enable communication between Neurelo and your MongoDB database, configure your MongoDB instance on Atlas in your Neurelo project. You will need following information from Atlas Cloud:

  • Go to the Overview page for your project. If your desired project is not active in the UI, choose the appropriate project from the Projects menu in the top-left navigation panel.

  • Select "Databases" from the options in the left navigation panel.

  • On the "Database Deployments" page, locate the database deployment (cluster) you wish to connect to, then click on the "Connect" button associated with that deployment.

  • From the Connect page, select "Compass". Copy the connection string from the Compass view as shown (you can use the Copy icons on the right of the string):

  • Connection string format

    • mongodb+srv://<username>:<password>@cluster0.<cluster><database_name>

    • You must replace the username, password, cluster, and database_name in the above string

Neurelo requires database_name to be present in the connection string. Atlas Cloud UI does not display the <database_name> in the connection string -- you will need to append it to the string.

  • To find and add the <database_name> in your connection string, go to the "Database Deployments" page, and locate the deployment (cluster) you wish to connect to, then click on the "Browse Collections" button associated with that deployment.

  • On the Collection view, you will find the list of databases. Copy the database name you wish to connect with Neurelo and paste it in your connection string

  • In the below screenshot, there is a database called "nyc_civil_service" on "Cluster0". Use this database name in your connection string. Your connection string would be -> mongodb+srv://<username>:<password>@cluster0.<cluster>

MongoDB Compass: You can also get the connection string and database name using the MongoDB Compass client -- details here.

Add MongoDB as a Data Source in a Neurelo Project

For each new project in Neurelo, you can utilize the Quick Start feature, a guided wizard for step-by-step onboarding, including adding a new Data Source like MongoDB Atlas. Additionally, you can create new Data Sources anytime within your project from the left-navigation panel.

Connecting MongoDB Atlas with a Connection String

  1. Login to your Neurelo Dashboard

  2. Choose the project where you want to add a new data source or create a new project for this purpose.

  3. For new projects, follow the Quick Start Guide and click on "Connect Data Source" button

    • For existing projects, navigate to "Data Sources" from the left navigation bar in the project and click on the "New" button

  4. Access the new data source dialog box. Enter the connection string obtained earlier from the MongoDB Atlas UI (and make sure it has <database_name> added). After entering the connection details, click on "Test Connection" to verify that Neurelo can successfully connect to MongoDB Atlas. Once the test is successful, click Submit to save the configuration in Neurelo.

Last updated