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
Connection String Formats for Neurelo
Neurelo will accept the connection string in either of these formats
mongodb+srv://username:password@cluster0.cluster.mongodb.net/database_name
mongodb://username:password@host:port/database_name
You need to replace the username, password, host, port, cluster, and database_name in the above strings as appropriate
Collect MongoDB connection details from the 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 icon on the right of the 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.
Getting MongoDB database_name from the Atlas UI
To find and add the <database_name> in your connection string, go to the "Database Deployments" page in the Atlas UI, and locate the deployment (cluster) you wish to connect to, then click on the "Browse Collections" button associated with that deployment.
In the Collection view, you will find the list of databases. Copy the database name you wish to connect with Neurelo and append it to 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).
Add Neurelo IP addresses to your Atlas IP access list. The Neurelo IP addresses to use for your project will be displayed in this dialog box.
Allowed inbound IP addresses: The default setting for Atlas Cloud services does not allow access from all IP ranges. You must add Neurelo's IPs to your allowed list on Atlas Cloud
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. Please refer to this page for additional information.
Last updated
