Skip to main content

Provision a database cluster

This is the complete field reference for provisioning a MongoDB Enterprise cluster. If this is your first cluster, Create your first database walks the same wizard with more context and covers service activation.

The wizard has three steps: database configuration, additional services, then review.

Step 1 — Database configuration​

Open the Database cluster list and select Create a Database Engine or Create.

Provisioning step 1 — engine, network, and node configuration

General information​

FieldDescription
Engine TypeSelect MongoDB.
EditionSelect Enterprise.
Architecture TypeStandalone for a one-node cluster, ReplicaSet for a replicated cluster, Sharded Cluster to partition data across shards. Cannot be changed later — see Choosing an architecture.
Engine VersionA supported version. See Database Engine Versions.

Network information​

FieldDescription
Edge GatewayRoutes network traffic between the cluster and other systems.
NetworkThe Network/Subnet the cluster deploys into. Defines access scope and network isolation.

Engine information​

FieldDescription
Cluster Name8–25 characters. Starts with a letter; letters, numbers, and hyphens only.
Database Name8–25 characters. Starts with a lowercase letter; lowercase letters, numbers, and underscores only.
Password / Confirm Password12–20 characters, including uppercase, lowercase, a number, and a special character.

Spaces and these characters are rejected in the password:

/ \ " ' < > ? % ; : $ ! [ ] { } ( ) , & +

Node configuration​

Storage Policy applies to the whole cluster whatever the architecture. It defines storage performance (IOPS) — use ≥ 4,000 IOPS for production.

The fields below it depend on the Architecture Type you selected.

Standalone and ReplicaSet​

FieldDescription
Number Of NodesNode count, matching the chosen architecture.
FlavorCompute resources per node — vCPU and RAM.
Data Disk Size (GB)Data disk allocation. Minimum 20 GB.

Sharded Cluster​

Provisioning wizard with Architecture type set to Sharded Cluster, showing the Mongos, Shard, and ConfigServer groups

A Sharded Cluster is sized in three independent groups, each with its own node count and flavor. See What a Sharded Cluster is made of for what each role does.

Mongos — the query routers your clients connect to.

FieldDescription
Number Of NodesRouter count. Integer between 2 and 32.
FlavorvCPU and RAM per router.

Mongos nodes hold no data, so there is no data storage field for this group.

Shard — the nodes that store the data.

FieldDescription
Number Of ShardsShard count. Integer between 2 and 32. Each shard is deployed as a 3-node replica set, so the data node count is three times this number.
FlavorvCPU and RAM per data node.
Data StorageData disk per node. Minimum 20 GB.

ConfigServer — the replica set holding cluster metadata.

FieldDescription
Number Of NodesFixed at 3 and not editable.
FlavorvCPU and RAM per config server.
Data StorageData disk per node. Minimum 20 GB.
note

The smallest Sharded Cluster the console will build is 11 nodes: 2 mongos, 2 shards × 3 data nodes, and 3 config servers. Size your quota accordingly before you start.

Click Next Step.

Step 2 — Additional services​

Backup and PITR are enabled by default on MongoDB Enterprise clusters. This step configures the maintenance window and notification recipients.

Enable Additional Service turns the add-on services on or off as a group. Leaving it off creates the cluster without them; you can enable them afterwards.

Compute scaling​

FieldDescription
CPU Threshold (%)CPU usage that triggers scaling.
RAM Threshold (%)Memory usage that triggers scaling.
Tracing IntervalMonitoring interval used to evaluate usage before scaling.
Current FlavorThe node's current compute flavor.
List Flavor ScalingTarget flavors the system may scale up to, sorted ascending.

Storage scaling​

FieldDescription
Current Storage (GB)Currently allocated storage.
Storage Threshold (%)Usage that triggers automatic scaling.
Storage Scale (%)Percentage increase applied per scaling operation.

Maintenance window​

FieldDescription
Day of WeekMonday through Sunday.
Start TimeWhen maintenance may begin. Duration is 1 hour from this time.

Notification recipients​

Email addresses that receive backup and scaling notifications. Add more with the + button.

Click Next Step.

Step 3 — Review and create​

Review every setting. Back returns you to edit; Create confirms.

The system checks resource availability, then begins deployment. You are returned to the cluster list with the new cluster at the top in Processing status.

Creation typically takes 5–7 minutes, after which the cluster reaches Running.

note

If provisioning fails, delete the failed cluster and provision again. A failed cluster cannot be recovered in place.

Next steps​