MongoDB Atlas
Overview
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
Reference - Neurelo Supported Databases and Versions
Get Started with MongoDB Atlas
MongoDB Atlas (https://www.mongodb.com/atlas/database) 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.
Sign up: If you don't already have an account, you can get started for free with Atlas.
MongoDB Atlas Database Service: Instructions to create MongoDB Atlas free cluster service. You must complete following steps:
Create an organization with a project
Create an active database cluster in your account
Configure a database user in your cluster
Add Neurelo IP addresses to your Atlas IP access list
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>.mongodb.net/<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.net/nyc_civil_service
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
Login to your Neurelo Dashboard
Choose the project where you want to add a new data source or create a new project for this purpose.
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
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
