> For the complete documentation index, see [llms.txt](https://docs.ionos.com/cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ionos.com/cloud/~/revisions/AMiYziCllTKB2y2lmONY/databases/mongodb/dcd-how-tos/update-mongodb-cluster.md).

# Update a MongoDB Cluster

You can update an existing MongoDB cluster on any of the following editions: **Playground**, **Business**, or **Enterprise**.

## Edit a Cluster

{% hint style="info" %}
**Prerequisites:** Make sure the MongoDB database cluster is added by following the steps in [<mark style="color:blue;">Set up a MongoDB Cluster</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/databases/mongodb/dcd-how-tos/set-up-mongodb-cluster.md).
{% endhint %}

{% hint style="info" %}
**Note:** All the available MongoDB clusters that are part of your contract are listed under the **MongoDB Clusters** section on the **Databases** page.
{% endhint %}

{% tabs %}
{% tab title="MongoDB Playground" %}
1\. In the [<mark style="color:blue;">Data Center Designer</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/getting-started/basic-tutorials/log-in-dcd.md), click **Menu** > **Databases** > **Postgres & MongoDB**.

2\. In the **Databases** window under the **MongoDB Clusters** section, click the database cluster that is added for the **Playground** edition.

![MongoDB Clusters](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-7d4235d7a1a39ded50b966cb19ba78dc4bc27379%2Fmongodb-clusters-playground.png?alt=media)

{% hint style="info" %}
**Note:** From this page, you can perform the following actions: **Copy connection URI** ![Copy connection URI](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-785c0732b76a3ac2c7badcc1c65a834f38abeefe%2Fmongodb-copy-connection-uri.png?alt=media) and **User Management** ![User management](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-79dde6b8fa31116892fbe81b4c8433074feccea5%2Fmongodb-user-mangement.png?alt=media).
{% endhint %}

3\. Click **edit** ![MongoDB edit cluster](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-f5856326bc29db4ae3cb6d256d8aa9ecb445ce49%2Fmongodb-cluster-edit.png?alt=media) to modify the cluster details for the selected database cluster.

4\. In the **Edit Form**, you can update the following cluster details:

* **Display Name:** Edit the name of the MongoDB cluster.
* **Edition:** You can upgrade the existing cluster edition from **Playground** to either **Business** or **Enterprise**.
* **Template:** Based on the edition selected, choose from the list of templates you want to update the cluster with.
* **Instances:** Depending on the edition and template selected, you would see the allowed number of instances you could choose from. For example, if the existing cluster is updated to **Business** edition and a **MongoDB Business S** template is selected, then, you could choose to edit the number of instances to either one or three instances.

{% hint style="info" %}
**Note:** The **Estimated price** will be displayed based on the input. The estimated cost is exclusive, where certain variables like traffic and backup are not considered.
{% endhint %}

![Edit MongoDB Playground cluster](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-a0f13e01cc8cc91234ce217e003761d123e7eeac%2Fmongodb-cluster-playground-edit-template.png?alt=media)

5\. In the **Cluster to Datacenter Connection** section, click **edit** ![MongoDB edit data center](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-88988c1b95bfa0168c4215bcaafcfc8e2943ff99%2Fmongodb-cluster-datacenter-edit.png?alt=media) to perform the following actions:

* Delete an existing IP address.
* Add new **Private IP/Subnet List**.

![Edit MongoDB Playground cluster to data center connection](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-9cacdd847259e85ae09bf5fe475dc0035742ab8a%2Fmongodb-cluster-playground-edit-datacenter-ip.png?alt=media)

6\. In the **Maintenance Window**, you can edit the following details:

* **Maintenance time:** Choose the appropriate time from the clock displayed.
* **Maintenance day:** From the dropdown list, modify the preferred day on which the maintenance of the cluster must take place.

![MongoDB cluster maintenance window](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-0f9fe5315231dd9a2b4016d78bc0c368ee5a2b5e%2Fmongodb-cluster-playground-edit-maintenance.png?alt=media)

7\. Click **Save** to provision your changes.

{% hint style="success" %}
**Result:** The existing MongoDB cluster is updated with the newly defined values. You can review the updated cluster details under the **Properties** section.
{% endhint %}

![MongoDB cluster properties - Playground edition](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-5303dee99d217b60a3f2757bbb2b2d1c45dc8233%2Fmongodb-cluster-playground-properties.png?alt=media)

**Next steps:** In editing a cluster, you can also perform the following actions:

* In the **User Management** section, click **Add** to create and manage user roles for the MongoDB cluster. For more information, see [<mark style="color:blue;">Roles</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/databases/mongodb/api-howtos/users-management.md#roles).
* Delete an existing cluster by using the delete option ![MongoDB delete a cluster](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-c9c6bb50470bf69d0ac21c5e36b903d5c99c3faa%2Fmongodb-delete.png?alt=media).

{% hint style="info" %}
**Note:** Database snapshots are not available for clusters in the **Playground** edition. For more information, see [<mark style="color:blue;">Features</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/databases/mongodb/overview.md#features).
{% endhint %}
{% endtab %}

{% tab title="MongoDB Business" %}
1\. In the [<mark style="color:blue;">Data Center Designer</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/getting-started/basic-tutorials/log-in-dcd.md), click **Menu** > **Databases** > **Postgres & MongoDB**.

2\. In the **Databases** page under the **MongoDB Clusters** section, click the database cluster that is added for the **Business** edition.

![MongoDB Clusters](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-bb79a9d4e506600d41ebdbe91d12e0c3d1af877c%2Fmongodb-clusters-business.png?alt=media)

{% hint style="info" %}
**Note:** From this page, you can perform the following actions: **Copy connection URI** ![Copy connection URI](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-785c0732b76a3ac2c7badcc1c65a834f38abeefe%2Fmongodb-copy-connection-uri.png?alt=media) and **User Management** ![User management](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-79dde6b8fa31116892fbe81b4c8433074feccea5%2Fmongodb-user-mangement.png?alt=media).
{% endhint %}

3\. Click **edit** ![MongoDB edit cluster](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-f5856326bc29db4ae3cb6d256d8aa9ecb445ce49%2Fmongodb-cluster-edit.png?alt=media) for the selected database cluster to modify the cluster details.

4\. In the **Edit Form**, you can update the following cluster details:

* **Display Name:** Edit the name of the MongoDB cluster.
* **Edition:** You can upgrade the existing cluster edition from **Business** to **Enterprise**.
* **Template:** Based on the edition selected, choose from the list of templates you want to update the cluster with.
* **Instances:** Depending on the edition and template selected, you would see the allowed number of instances you could choose from. For example, if the existing cluster is updated to **Business** edition and a **MongoDB Business L** template is selected, then, you could choose to edit the instances to either one or three instances.

{% hint style="info" %}
**Note:** The **Estimated price** will be displayed based on the input. The estimated cost is exclusive, where certain variables like traffic and backup are not considered.
{% endhint %}

![Edit MongoDB Business cluster](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-a12778ba3aa1e8975f3b3329dab1bd8792674214%2Fmongodb-cluster-business-edit-template.png?alt=media)

5\. In the **Cluster to Datacenter Connection** section, click **edit** ![MongoDB edit data center](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-88988c1b95bfa0168c4215bcaafcfc8e2943ff99%2Fmongodb-cluster-datacenter-edit.png?alt=media) to perform the following actions:

* Delete an existing IP address.
* Add new **Private IP/Subnet List**.

![Edit MongoDB Business cluster to data center connection](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-9cacdd847259e85ae09bf5fe475dc0035742ab8a%2Fmongodb-cluster-playground-edit-datacenter-ip.png?alt=media)

6\. In the **Maintenance Window**, you can edit the following details:

* **Maintenance time:** Choose the appropriate time from the clock displayed.
* **Maintenance day:** From the dropdown list, modify the preferred day on which the maintenance of the cluster must take place.

![MongoDB cluster maintenance window](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-0f9fe5315231dd9a2b4016d78bc0c368ee5a2b5e%2Fmongodb-cluster-playground-edit-maintenance.png?alt=media)

7\. Click **Save** to provision your changes.

{% hint style="success" %}
**Result:** The existing MongoDB cluster is updated with the newly defined values. You can review the updated cluster details under the **Properties** section.
{% endhint %}

![MongoDB cluster properties - Business edition](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-2f7c23c64d3e09ed7ee0d91a5d0a6be883a0e05e%2Fmongodb-cluster-business-properties.png?alt=media)

**Next steps:** In editing a cluster, you can also perform the following actions:

* In the **User Management** section, click **Add** to create and manage user roles for the MongoDB cluster. For more information, see [<mark style="color:blue;">Roles</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/databases/mongodb/api-howtos/users-management.md#roles).
* In the **Snapshots** section, restore the data in the cluster from the selected snapshot. For more information, see [<mark style="color:blue;">Restore a MongoDB Cluster via the DCD</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/databases/mongodb/dcd-how-tos/restore-mongodb-cluster.md).
* Delete an existing cluster by using the delete option ![MongoDB delete a cluster](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-c9c6bb50470bf69d0ac21c5e36b903d5c99c3faa%2Fmongodb-delete.png?alt=media).

{% hint style="info" %}
**Note:** When you delete a cluster, all of its backup data is also immediately deleted.
{% endhint %}
{% endtab %}

{% tab title="MongoDB Enterprise" %}
1\. In the [<mark style="color:blue;">Data Center Designer</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/getting-started/basic-tutorials/log-in-dcd.md), click **Menu** > **Databases** > **Postgres & MongoDB**.

2\. In the **Databases** window, click the database cluster that is added for the **Enterprise** edition.

![MongoDB Clusters](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-a19adf7fae707dedd364c99695bc496894e0b909%2Fmongodb-cluster-enterprise.png?alt=media)

{% hint style="info" %}
**Note:** From this page, you can perform the following actions: **Copy connection URI** ![Copy connection URI](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-785c0732b76a3ac2c7badcc1c65a834f38abeefe%2Fmongodb-copy-connection-uri.png?alt=media) and **User Management** ![User management](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-79dde6b8fa31116892fbe81b4c8433074feccea5%2Fmongodb-user-mangement.png?alt=media).
{% endhint %}

3\. Click **edit** ![MongoDB edit cluster](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-f5856326bc29db4ae3cb6d256d8aa9ecb445ce49%2Fmongodb-cluster-edit.png?alt=media) for the selected database cluster to modify the cluster details.

4\. In the **Edit Form**, you can update the following cluster details:

* **Display Name:** Edit the name of the MongoDB cluster.
* **Edition:** You can only view the existing cluster edition set as **Enterprise**.

{% hint style="info" %}
**Note:** At this time, it is not possible to downgrade from the **Enterprise** edition to any other edition.
{% endhint %}

* **CPU Cores:** Update the number of CPU cores between 1 and 31 cores using the slider or choose from the available shortcut values.
* **RAM Size (GB):** Update RAM size for up to 230 GB is possible. Select the RAM size using the slider or choose from the available shortcut values.
* **Instances:** Choose from three, five, or seven instances to host a logical database manager environment to catalog your databases.

{% hint style="info" %}
**Note:** At this time, downscaling of instances is not supported.
{% endhint %}

{% hint style="info" %}
**Note:** The **Estimated price** will be displayed based on the input. The estimated cost is exclusive, where certain variables like traffic and backup are not considered.
{% endhint %}

![Edit MongoDB Enterprise cluster](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-5e5838f50175e5967bd3ce9778fe7ec737583ac3%2Fmongodb-cluster-enterprise-edit-template.png?alt=media)

5\. In the **Cluster to Datacenter Connection** section, click **edit** ![MongoDB edit data center](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-88988c1b95bfa0168c4215bcaafcfc8e2943ff99%2Fmongodb-cluster-datacenter-edit.png?alt=media) to perform the following actions:

* Delete an existing IP address.
* Add new **Private IP/Subnet List**.

![Edit MongoDB Enterprise cluster to data center connection](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-a4e34fa09fb4ee19d094ab1d46588f4a3afa69e8%2Fmongodb-cluster-enterprise-edit-ip.png?alt=media)

6\. Toggle on or off the **Enable BI Connector**. It is advised to enable the MongoDB Connector for Business Intelligence (BI) to query a MongoDB database by using SQL commands to aid in the data analysis.

7\. Update the offsite **Backup Location** to allow backup data to be stored in a location other than the deployed database cluster. Available backup locations: `de`, `eu-south-2`, `eu-central-2`.

![MongoDB cluster Backup and BI Connector](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-ad2936c82f0e803b3d8cd75dedf6799049eeaf13%2Fmongodb-cluster-enterprise-edit-biconnector.png?alt=media)

8\. In the **Maintenance Window**, you can edit the following details:

* **Maintenance time:** Choose the appropriate time from the clock displayed.
* **Maintenance day:** From the dropdown list, modify the preferred day on which the maintenance of the cluster must take place.

![MongoDB cluster maintenance window](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-0f9fe5315231dd9a2b4016d78bc0c368ee5a2b5e%2Fmongodb-cluster-playground-edit-maintenance.png?alt=media)

9\. Click **Save** to provision your changes.

{% hint style="success" %}
**Result:** The existing MongoDB cluster is updated with the newly defined values. You can review the updated cluster details under the **Properties** section.
{% endhint %}

![MongoDB cluster properties - Enterprise edition](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-829bdf98df20a3debb38fbaac24a4da3ce9ac794%2Fmongodb-cluster-enterprise-properties.png?alt=media)

**Next steps:** In editing a cluster, you can also perform the following actions:

* In the **User Management** section, click **Add** to create and manage user roles for the MongoDB cluster. For more information, see [<mark style="color:blue;">Roles</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/databases/mongodb/api-howtos/users-management.md#roles).
* In the **Snapshots** section, restore the data in the cluster from the selected snapshot. For more information, see [<mark style="color:blue;">Restore a MongoDB Cluster via the DCD</mark>](/cloud/~/revisions/AMiYziCllTKB2y2lmONY/databases/mongodb/dcd-how-tos/restore-mongodb-cluster.md).
* Delete an existing cluster by using the delete option ![MongoDB delete a cluster](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-c9c6bb50470bf69d0ac21c5e36b903d5c99c3faa%2Fmongodb-delete.png?alt=media).

{% hint style="info" %}
**Note:** When you delete a cluster, all of its backup data is also immediately deleted.
{% endhint %}
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.ionos.com/cloud/~/revisions/AMiYziCllTKB2y2lmONY/databases/mongodb/dcd-how-tos/update-mongodb-cluster.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
