Kvindo™ Cloud Docs
A Standalone PostgreSQL is a single-node PostgreSQL database on a dedicated VM. It is simpler and cheaper than a managed cluster — no replication or automatic failover — but production-ready: automated pgBackRest backups are written to S3 for point-in-time restore. Access is over the private VPC network by default.
• Compute & storage — sized by an offer ID for the VM (spec.vmOfferId) and a separate offer + size for the data volume (spec.volumeOfferId, spec.volumeSizeGiB)
• Network — lives in a VPC subnet (spec.vpcSubnetId); attach a Floating IP (spec.floatingIpId) only if you need public access
• Tuning — reference a Parameter Set (spec.parametersSetId) to apply postgresql.conf settings
• Backups — spec.backupRetentionDays controls how long pgBackRest archives are kept in S3
• Connection — the superuser name, private/public IP, and port are reported under status once provisioned
| UI Name | API / kc name | Terraform name | Optional | Format | Default | Is read only | Description |
|---|---|---|---|---|---|---|---|
| Tier | spec.tier |
spec.tier |
No | string | standard |
No | Reserved for future use — only standard is accepted today |
| Version | spec.version |
spec.version |
No | string — PostgreSQL major version | — | No | e.g. 16 |
| VPC subnet | spec.vpcSubnetId |
spec.vpc_subnet_id |
No | ULID — references a VPC Subnet | — | No | Subnet the instance runs in |
| Parameter set | spec.parametersSetId |
spec.parameters_set_id |
Yes | ULID — references a Parameter Set | — | No | postgresql.conf tuning to apply |
| Root password | spec.rootPassword |
spec.root_password |
No | string (sensitive) | — | No | Password for the superuser |
| Backup retention | spec.backupRetentionDays |
spec.backup_retention_days |
No | integer — days | — | No | How long pgBackRest archives are kept in S3 |
| Floating IP | spec.floatingIpId |
spec.floating_ip_id |
Yes | ULID — references a Floating IP | — | No | Public address; omit for private-only access |
| VM offer | spec.vmOfferId |
spec.vm_offer_id |
No | string (≤32) — compute offer | — | No | VM size; see the Console catalog |
| VM state | spec.vmState |
spec.vm_state |
Yes | string — running/stopped |
running |
No | Desired power state; defaults to running when omitted |
| Volume offer | spec.volumeOfferId |
spec.volume_offer_id |
No | string (≤32) — disk offer | — | No | Data volume type |
| Volume size | spec.volumeSizeGiB |
spec.volume_size_gib |
No | integer — GiB | — | No | Data directory size |
| Root user | status.rootUserName |
status.root_user_name |
— | string | — | Yes | The superuser name |
| Private IPv4 | status.privateIpV4 |
status.private_ipv4 |
— | string | — | Yes | Address on the VPC subnet |
| Public IPv4 | status.publicIpV4 |
status.public_ipv4 |
— | string | — | Yes | Set only when a Floating IP is attached |
| Port | status.port |
status.port |
— | integer | — | Yes | PostgreSQL listening port |
A private single-node instance on an existing subnet, with a Parameter Set attached and 7-day backup retention.
Terraform
Python SDK
kc CLI
Resource docs