[ Web Proxy ]
URL:
Viewing: https://docs.digitalocean.com/reference/doctl/reference/databases/replica/create/ [Back]  [Original]
doctl databases replica create | DigitalOcean Documentation

For AI agents: The documentation index is at 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 replica create

Generated on 18 Aug 2026 from doctl version v1.167.0

Copy page as Markdown View page as Markdown

Usage 

doctl databases replica create <database-cluster-id> <replica-name> [flags]

Aliases 

c

Description

Creates a read-only database replica for the specified database cluster, giving it the specified name.

This command requires the ID of a database cluster, which you can retrieve by calling:

doctl databases list

Example

The following example creates a read-only replica named example-replica for a database cluster with the ID ca9f591d-f38h-5555-a0ef-1c02d1d1e35:

doctl databases replica create ca9f591d-f38h-5555-a0ef-1c02d1d1e35 example-replica --size db-s-1vcpu-1gb

Flags

Option Description
--help, -h Help for this command
--private-network-uuid The UUID of a VPC to create the replica in; the default VPC for the region will be used if excluded.
--region Specifies the region in which to create the replica, such as nyc3 or sfo2.
Default: nyc1
--size Specifies the machine size for the replica, such as db-s-1vcpu-1gb. Must be the same size or larger than the primary database cluster.
Default: db-s-1vcpu-1gb
Command Description
doctl databases replica Display commands to manage read-only database replicas

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
    --trace Show a log of network activity while performing a command
    Default: false
    --verbose, -v Enable verbose output
    Default: false

    In this article...

    We can't find any results for your search.

    Try using different keywords or simplifying your search terms.

    Web Proxy Viewer  |  New URL  |  Original Page