# MongoDB Setup

***

### Step 1: Create an Account

#### Visit MongoDB Cloud:

1. **Open your web browser** and navigate to [MongoDB Cloud.](https://www.mongodb.com/products/platform/cloud)

#### Sign Up:

2. **Click on the Sign Up button**.
3. **Enter your email address and create a password**.
4. Alternatively, you can sign up using your **Google account**.

#### Accept Privacy Policy & Terms:

5. **Read through the Privacy Policy & Terms**.
6. **Check the box to accept them and proceed**.

#### Answer "Getting to Know You" Questions:

7. You will be presented with a few questions to help MongoDB understand your needs.
8. You can answer these questions randomly as they do not affect your setup.

***

### Step 2: Deploy Your Cluster

#### Choose the Free Tier:

1. After logging in, you will be directed to the **MongoDB Atlas dashboard**.
2. **Click on Build a Cluster**.
3. Select the **M0 (Free) tier option**.

#### Cluster Configuration:

**Name Your Cluster:**

4. You can leave the default name as **Cluster0** or choose a custom name.

**Cloud Provider & Region:**

5. Choose **AWS** as your cloud provider.
6. Select a region closest to you. (**Frankfurt** is recommended for European users).
7. Click **Create Cluster** to begin the deployment process.

***

### Step 3: Set Up a Database User

#### Create a Database User:

1. While your cluster is being created, you will need to set up a database user.
2. Go to the **Database Access tab**.
3. **Click on Add New Database User**.

#### Set a Username & Password:

4. Enter a username of your choice.
5. Create a strong password and make a note of it as you will need it later.
6. Click **Add User** to create the database user.

***

### Step 4: Choose a Connection Method

#### Connect to Your Cluster:

1. Once your cluster is created, go to the **Clusters view**.
2. **Click on the Connect button** for your cluster.

#### Choose a Connection Method:

3. Select **Connect Your Application**.

**Drivers:**

4. Select Drivers
5. Copy the connection string provided.

{% hint style="success" %}
**Note:** Ensure the connection string starts with `mongodb+srv://`.
{% endhint %}

#### Update Your Configuration File:

6. Open your **core.yml** file
7. Paste the connection string into the file.
8. Replace `<password>` in the connection string with the password you noted down earlier.

{% hint style="danger" %} <mark style="color:red;">I</mark><mark style="color:red;">**mportant:**</mark> Make sure to remove **`< >`**
{% endhint %}

***

### Step 5: Configure Network Access

#### Add IP Address:

1. Navigate to the **Network Access tab**.
2. **Click on Add IP Address**.
3. Enter the IP address of the server where you will be hosting your bot or application.
4. If you want to allow access from anywhere, you can add `0.0.0.0/0`, but this is not recommended for security reasons.
5. Click **Confirm** to add the IP address.

***

### Common Issues and Troubleshooting

#### Buffer Timeout

**Whitelist IP Address:**

1. Ensure your server's IP is whitelisted under the **Network Access tab**.

**Correct Password:**

2. Verify that the password you are using in the connection string is correct.
3. If you have forgotten your password, you can reset it in the **Database Access tab**:
   * Go to **Database Access**.
   * Click **Edit** next to the user.
   * Enter a new password and save the changes.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.drakodevelopment.net/getting-started/mongodb-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.