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).

You can resize existing Valkey database clusters at any time to change CPU, RAM, and storage, including scaling down when the target plan’s memory capacity can accommodate your current in-memory data.

Scaling Down

Valkey stores its working dataset in memory. You can scale down only when the target plan’s available memory can accommodate your cluster’s current in-memory data. Valkey reserves part of each node’s memory for cluster operations, so the usable memory per plan is lower than the total RAM. For available memory by plan size, see Valkey memory usage. If the target plan’s available memory is less than your current in-memory data, the Control Panel blocks the resize to prevent data loss.

For example, starting from a plan with 16 GiB RAM (11.5 GiB available memory) and 4.8 GiB of in-memory data:

Resize a Database Cluster Using Automation

You can resize a database cluster using the DigitalOcean CLI (doctl) or the API.

Resize a Database Cluster via CLI

To resize a database cluster using doctl, you need to provide a value for the --size flag, which specifies the cluster’s new configuration (number of CPUs, amount of RAM, and hard disk space). Use the doctl databases options slugs command to get a list of available values.

doctl databases resize ca9f591d-9999-5555-a0ef-1c02d1d1e352 --num-nodes 2 --size db-s-16vcpu-64gb --storage-size-mib 2048000 --wait true

Resize a Database Cluster via API

To resize a database cluster using the API, you need to provide a value for the size field, which specifies the cluster’s configuration (number of CPUs, amount of RAM, and hard disk space). Use the /v2/databases/options endpoint to get a list of available values.

curl -X PUT \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
-d '{"size":"db-s-4vcpu-8gb", "num_nodes":3, "storage_size_mib":163840}' \
"https://api.digitalocean.com/v2/databases/9cc10173-e9ea-4176-9dbc-a4cee4c4ff30/resize" 

import (
    "context"
    "github.com/digitalocean/godo"
)

func main() {
    pat := "mytoken"

    client := godo.NewFromToken(pat)
    ctx := context.TODO()

    resizeRequest := &godo.DatabaseResizeRequest{
        SizeSlug: "db-s-4vcpu-8gb",
        NumNodes: 3,
        StorageSizeMib: 163840,
    }
}

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

req = {
  "size": "db-s-4vcpu-8gb",
  "num_nodes": 3,
  "storage_size_mib": 163840
}

update_resp = client.databases.update_cluster_size(database_cluster_uuid="a7a8bas", body=req)

Resize a Database Cluster Using the Control Panel

To resize a Valkey database cluster, go to the Databases page, and select the cluster you want to resize. On the cluster’s Overview page, click the Settings tab.

In the Configuration section, click Edit. Select a tab to view available Shared CPU or Dedicated CPU plans, then choose options under CPU options and Select a plan.

In the Maximize uptime for critical workloads section (for plans with 2 GB RAM or higher), you can add standby nodes.

Click Save to apply your changes.

Your cluster’s state changes from Active to Resizing until the process is complete. Provisioning can take several minutes, depending on cluster size, but does not cause downtime.