Create a Connection String

You can connect to your MongoDB deployment by providing a connection URI, also called a connection string, which tells Mongoid how to connect to a MongoDB deployment and behave while connected.

The connection string includes the hostname or IP address and port of your deployment, the authentication mechanism, user credentials when applicable, and connection options.

To learn about connecting to an instance or deployment not hosted on Atlas, see Connection Strings in the Server manual.

Find your MongoDB Atlas connection string

To retrieve your connection string for the deployment that you created in the previous step, log in to your Atlas account. Then, navigate to the Database section and click the Connect button for your new deployment.

The connect button in the clusters section of the Atlas UI

Proceed to the Connect your application section. Select Ruby from the Driver selection menu and the most recent Ruby driver version from the Version selection menu.

Deselect the View full code sample option to view only the connection string.

Copy your connection string

Click the button on the right of the connection string to copy it to your clipboard.

Update the placeholders

Paste the connection string into a file in your preferred text editor and replace the <username> and <password> placeholders with your database user's username and password.

Save this file to a safe location for use in the next step.

After completing these steps, you have a connection string that contains your database username and password.

Note

If you run into issues, ask for help in the MongoDB Community Forums or submit feedback by using the Feedback button in the upper right corner of the page.

Back

Create a MongoDB Deployment

Configure Your MongoDB Connection