Retrieving a MongoDB URI

We will be using Mongo DB Atlas, you do not need a credit card to obtain a free tier database cluster.

https://www.mongodb.com/cloud/atlas

  1. Create an account by clicking the “Start free” button.
  2. Look for the ones that have the following label. We recommend choosing a server near your Discord Server region.
    Free Tier Available
  3. Be sure you’re on the M0 Sandbox tier, this is the only free tier offered by MongoDB Atlas. Choosing anything else will require payment.
  4. Don’t enable Additional Settings and set anything as the cluster name.
  5. Look for the following box on the bottom left of the screen, if it’s not there, wait for a minute and then refresh the page.
    checkmark
    Get Started
    4
  6. Complete the remaining steps, skip the optional “Load Sample Data” step. Read through #7 - #9 before completing this step.
  7. User should have either “Atlas admin” or “Read and write to any database” permission.
  8. You will need to remembed the User password, do not include any symbols or special characters as they often cause problems with authentication.
  9. When Whitelisting IP, if you’re hosting from Heroku, you must select “ALLOW ACCESS FROM ANYWHERE” or enter “0.0.0.0/0” as the Whitelist Entry.
  10. The last “Connect to your cluster step” (if the “Connect” button is grayed out, wait, it can take up to 20 minutes), select “Connect Your Application”, leave the “driver version” as-is (Node.js 3.0 or higher), copy down the “Connection String”, which looks similar to: mongodb+srv://admin:<password>@modmail-apsk.azure.mongodb.net/test?retryWrites=true&w=majority.
  11. Paste the connection string from #10 and the password from #8 into their respective forms below. Do not subsitute in <password>, the form will correctly do so for you.