---
title: doctl databases create
description: |-
    Creates a database cluster with the specified name.

    You can customize the configuration using the listed flags, all of which are optional. Without …
product: Reference
url: https://docs.digitalocean.com/reference/doctl/reference/databases/create/
last_updated: "2026-11-05"
---

> **For AI agents:** The documentation index is at [https://docs.digitalocean.com/llms.txt](https://docs.digitalocean.com/llms.txt). Markdown versions of pages use the same URL with `index.html.md` in place of the HTML page (for example, append `index.html.md` to the directory path instead of opening the HTML document).

# doctl databases create

Generated on 5 Nov 2026 from `doctl` version [`v2.3.0`](https://github.com/digitalocean/doctl/releases/tag/v2.3.0)

## Usage

```shell
doctl databases create <name> [flags]
```

## Aliases

```shell
c
```

## Description

Creates a database cluster with the specified name.

You can customize the configuration using the listed flags, all of which are optional. Without any flags set, the command creates a single-node, single-CPU PostgreSQL database cluster.

## Example

The following example creates a database cluster named `example-database` in the `nyc1` region with a single 1 GB node:

```shell
doctl databases create example-database --region nyc1 --size db-s-1vcpu-1gb --num-nodes 1
```

## Flags

| Option | Description |
|---|---|
| `--engine` | The database’s engine. Possible values are: `pg`, `mysql`, `advanced_pg`, `advanced_mysql`, `redis`, `valkey`, `mongodb`, `kafka` and `opensearch`., Default: `pg` |
| `--help`, `-h` | Help for this command |
| `--num-nodes` | The number of nodes in the database cluster. Valid values are 1-3. In addition to the primary node, up to two standby nodes may be added for high availability., Default: `1` |
| `--private-network-uuid` | The UUID of a VPC to create the database cluster in. The command uses the region’s default VPC if excluded. |
| `--region` | The data center region where the database cluster resides, such as `nyc1` or `sfo2`., Default: `nyc1` |
| `--restore-from-cluster-name` | The name of an existing database cluster to restore from. |
| `--restore-from-timestamp` | The timestamp of an existing database cluster backup in UTC combined date and time format (2006-01-02 15:04:05 +0000 UTC). The most recent backup is used if excluded. |
| `--size` | The size of the nodes in the database cluster, for example `db-s-1vcpu-1gb` indicates a 1 CPU, 1GB node. For a list of available size slugs, visit: /reference/api/reference/databases/, Default: `db-s-1vcpu-1gb` |
| `--storage-size-mib` | The amount of disk space allocated to the cluster. Applicable for PostgreSQL and MySQL clusters. Each plan size has a default value but can be increased in increments up to a maximum amount. For ranges, visit: [https://www.digitalocean.com/pricing/managed-databases](https://www.digitalocean.com/pricing/managed-databases), Default: `0` |
| `--tag` | A comma-separated list of tags to apply to the database cluster. |
| `--version` | The database engine’s version, such as 14 for PostgreSQL version 14. |
| `--wait` | A boolean value that specifies whether to wait for the database cluster to be provisioned before returning control to the terminal., Default: `false` |
| `--wait-timeout` | The longest doctl waits for the operation to finish, as a `duration` such as 10m or 1h30m. When it elapses, doctl stops waiting and exits with an error, but the operation itself keeps running., Default: `30m0s` |

## Related Commands

| Command | Description |
|---|---|
| [doctl databases](https://docs.digitalocean.com/reference/doctl/reference/databases) | Display commands that manage databases |

## Global Flags

Option Description

`--access-token`, `-t` API V2 access token

`--api-url`, `-u` Override default API endpoint

`--config`, `-c` Specify a custom config file, Default:

`--context` Specify a custom authentication context name

`--http-retry-max` Set maximum number of retries for requests that fail with a 429 or 500-level error , Default: `5`

`--http-retry-wait-max` Set the minimum number of seconds to wait before retrying a failed request , Default: `30`

`--http-retry-wait-min` Set the maximum number of seconds to wait before retrying a failed request , Default: `1`

`--interactive` Enable interactive behavior. Defaults to true if the terminal supports it (default false) , Default: `false`

`--output`, `-o` Desired output format \[text|json], Default: `text`

`--show` Reveal masked values, such as secrets, instead of hiding them. Values are unmasked automatically in CI , Default: `false`

`--trace` Show a log of network activity while performing a command, Default: `false`

`--verbose`, `-v` Enable verbose output, Default: `false`