Updating PostgreSQL cluster settings
Written by
Updated at April 8, 2026
If you have a PostgreSQL cluster in your project, you can update its settings.
CLI
Management console
-
Open the
PostgresqlClusterresource, e.g., using theopen postgresqlcluster.yamlcommand. -
Open the resource file and edit the following properties:
metadata.name: Cluster name.metadata.namespace: Project name.spec.instances: Number of cluster replicas.spec.storage.size: Storage size. You can only increase it.spec.storage.autoScaling.enabled: Enabling automatic storage expansion.spec.storage.autoScaling.maxSize: Maximum storage size.spec.storage.autoScaling.standardIncreasePercent: Storage expansion percentage.spec.storage.autoScaling.resizeTriggerPercent: Storage usage percentage threshold that triggers storage expansion.spec.storage.readOnlyTriggerPercent: Disk usage percentage to switch to read-only mode.spec.enableSuperuserAccess: You can disable superuser access while editing.spec.resources: Pod resource limits.spec.postgresConfiguration: PostgreSQL configuration.spec.poolers.[ro|rw|r].port: Connection pooler port settings.spec.poolers.[ro|rw|r].instances: Number of connection pooler replicas.spec.poolers.[ro|rw|r].type: Cluster type for the connection pooler, e.g.,ClusterIP.spec.poolers.[ro|rw|r].odyssey.poolMode: Operation mode of the database connection pool (session or transaction).spec.backup: Backup settings.spec.deletionProtection: Deletion protection. If set totrue, you cannot delete the cluster until the protection is disabled.
-
Apply the manifest:
kubectl apply -f postgresqlcluster.yaml -n <project name>. Optionally, you can specify the project name in themetadata.namespaceresource property and skip it in the command.
-
If you have not opened a project yet, select one.
-
In the left-hand menu, select PostgreSQL Clusters.
-
Select the cluster.
-
Click Edit.
-
Edit the following fields:
- Cluster name. Only use lowercase letters, numbers, and hyphens.
- Number of instances: Number of cluster replicas.
- Computing resources, where Limits is the upper limit and Requests is the lower limit.
- Storage: Increase the storage size or enable automatic storage expansion.
- Connection pooler: Handles writes and reads; used for all data-modifying operations and critical transactions.
- Backups: Settings for creating the database backup in an S3 bucket.
- Deletion protection: Toggle. You cannot delete the cluster until the protection is disabled.
-
Click Save.
This is it, your cluster settings have been updated.