mongodb_atlas_setup.md

This guide will show you how to set up a MongoDB Atlas database for use with TuringBot. The setup for M0 (the free tier) is free of charge.

Creating the DB cluster

1. Head to the signup page and fill your details in, agree to the terms and click Create your Atlas account

2. Once logged in, you will get a welcome screen prompting you to deploy the database cluster. Fill it in as you wish and click Finish
   

3. You will now be prompted with some more advanced DB info. Make sure to set the server to M0 if you want the Free tier. Click Create once you are done.
   

4. You will now be faced with the login setup. Create an user that you will log in with, mark the username and password down.
   

5. Add your IP address (if it hasn't been added already), if you have a dynamic ip make sure to add your whole subnet. Once done, click on Finish and close

The cluster is now created and ready for use with Turingbot.

Connecting to the DB Cluster

1. Click on Connect
   

2. Click on Shell, the third step will contain the address of your main DB cluster shard. Copy the value in quotation marks as imaged (excluding the protocol (mongodb+srv://), including the trailing /)
   

3. You are now done with the online setup and can open the bot config up and fill the info in accordingly:

 "mongodb": {
    "protocol": "mongodb+srv://",
    "address": "<the value you just copied>",
    "username": "<username>",
    "password": "<password>"
  },

You can now start the bot and use the MongoDB dependency.