Integrate with Render
On this page
You can connect Render-hosted applications to an Atlas cluster.
Use this page to complete the following tasks:
Create and configure an Atlas cluster.
Connect to your Render-hosted application.
To learn more, see the Render documentation.
Considerations
To connect a Render-hosted application to an Atlas cluster, you must select AWS as the cloud provider for your Atlas cluster.
Create and Configure an Atlas Cluster
To create and configure a cluster in the Atlas UI:
In Atlas, go to the Clusters page for your project.
If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
If it's not already displayed, select your desired project from the Projects menu in the navigation bar.
If it's not already displayed, click Clusters in the sidebar.
The Clusters page displays.
Select a cluster type.
To learn more, see Select Cluster Tier.
Select a region.
Select the AWS region closest to the region where your Render-hosted application is deployed.
Render Region | AWS Region | Atlas region |
|---|---|---|
Oregon, USA | us-west-2 | US_WEST_2 |
Ohio, USA | Dedicated tier: us-east-2Shared tier: us-east-1 | Dedicated tier: US_EAST_2Shared tier: US_EAST_2 |
Virginia, USA | us-east-1 | US_EAST_1 |
Frankfurt, Germany | eu-central-1 | EU_CENTRAL_1 |
Singapore | ap-southeast-1 | AP_SOUTHEAST_1 |
Specify how you would like to authenticate the connection to your Atlas cluster.
In the How would you like to authenticate your connection? section of the Quickstart page, you can configure one of the following options for your cluster.
You can create environment variables for the following values in your Render service that connects to Atlas.
Click Username and Password.
Set the new user's Username and Password.
Click Create User.
Click Certificate. MongoDB uses X.509 certificates for passwordless authentication.
Specify the Common Name (CN) for the new user.
Optional. Toggle the Download certificate when user is added to On to download the certificate after creating the user.
If you choose to download the certificate, you must also specify certificate expiration. To specify the duration, choose the duration for the certificate from the dropdown. You can set the certificate expiration to
3,6,12, or24months.Click Add User.
The new user is granted
Project Data Access Read/Writerole by default.
Specify from where you would like to connect to your Atlas cluster.
You can enable access for any network that needs to read and write data to your cluster. To enable access, you can configure access from the Render cloud environment to your cluster.
Choose Cloud Environment to configure network access between Atlas and your Render environment.
Add your Render service's static outbound IP addresses.
Connect to Your Render-Hosted Application
You can view a connection string in the Atlas UI and use it to connect to your Render-hosted application.
In Atlas, go to the Clusters page for your project.
If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
If it's not already displayed, select your desired project from the Projects menu in the navigation bar.
If it's not already displayed, click Clusters in the sidebar.
The Clusters page displays.
View your connection string in the Atlas UI.
Click the Connect button for your cluster.
Select the Standard Connection type.
Click Choose a connection method.
Click Drivers.
To learn more, see Drivers.
Select the driver, install the driver, and copy the connection string.
To learn more, see Connection Strings.
Connect to your Render-hosted application.
Return to your Render dashboard.
Create environment variables to authenticate the connection to your Atlas cluster.
To learn more, see Environmental Variables and Secrets in the Render documentation.
Add the connection string to your application code.