PricingPricingDocsDocsBlogBlogBook a demoBook a demoCompanyCompany (opens in a new tab)
Product
DocsAPI ReferencePricingConsole DemoBlogCompany
Start Freev3.4.7
Platform & Observability

PV Auto-Expansion

Wave grows a PVC when its usage reaches the threshold you set, by a percentage or a fixed size, up to an optional max capacity.

The challenge

The PVC reaches 100%, and Kubernetes waits for someone to edit its size

kubernetes.io, Persistent Volumes; Wave Auto Expansion docs. 80%, +50%, and 10 GiB are docs examples and are illustrative here.

Kubernetes grows a volume only when someone asks: "To request a larger volume for a PVC, edit the PVC object and specify a larger size." It works only if the StorageClass sets allowVolumeExpansion to true (kubernetes.io).

Nothing in Kubernetes watches usage and edits the PVC for you. And "Kubernetes does not support shrinking a PVC to less than its current size" (kubernetes.io), so any automatic growth needs a limit.

A volume that fills up, then a volume that grows at its thresholdWithout WaveWith Wave100%full at 100%grows at 80%
Without Wave
Nothing edits the PVC: usage reaches 10 GiBCapacityUsedWaits for someone to edit the PVC10 GiBfull: writes fail0102030 days
Usage grows every day, and the 10 GiB capacity stays the same. On day 10 the volume is full, and writes fail until someone edits the PVC.
With Wave
Wave grows the PVC at 80%, up to the maxCapacityUsed10 GiB15 GiB22.5 GiBmax 30 GiB0102030 days
Each time usage reaches 80% of capacity, Wave grows the PVC by 50%: 10 to 15 to 22.5 GiB. The next step would pass the max, so it stops at 30 GiB.

Editing the PVC to grow it: kubernetes.io, Persistent Volumes. 80%, +50%, and 10 to 15 to 22.5 GiB: Wave Auto Expansion docs example. The usage curve and the 30 GiB max are illustrative.

How Wave does it

From a full volume to a PVC that grows at your threshold
Kubernetes by defaultWaits for a person
  1. PVC
    the app keeps writing
  2. ↓no check→
    Someone
    notices the volume is full
  3. ↓edits→
    PVC spec
    a larger storage request
  4. ↓resize→
    Volume
    grows if the StorageClass allows it
PV Auto ExpansionGrows at your threshold
  1. Wave Core
    checks usage every few minutes
  2. ↓trigger→
    Your rule
    +% or a fixed size, optional max
  3. ↓new size→
    StorageClass
    must allow volume expansion
  4. ↓update→
    PVC
    tracked to Completed or a failure status
Default lane: kubernetes.io (Persistent Volumes). Wave lane: Wave Auto Expansion docs and PV Lifecycle CRDs docs.
1

Set a threshold per PVC

In the console, or as a WavePvcAutoExpansion Custom Resource, set the usage percentage that starts an expansion, for example 80%. The threshold has no default, so you choose it for each PVC.

2

Choose how much to grow

Grow by a percentage of the current size, such as 10 GiB to 15 GiB at 50%, or by a fixed size. An optional Max Capacity sets the ceiling, and Wave trims the last step so it lands exactly on it.

3

Follow every attempt

Wave checks that the StorageClass allows expansion, then updates the PVC. The logs show InProgress, Completed, or a failure such as ExpansionFailed or MaxCapacityReached. Some storage providers need a Pod restart or downtime to finish the resize.

Related in Platform & Observability

Programmable API →SSO (OIDC) →PV Cleanup →Alerts →Cluster Map →Prometheus & Grafana Integration →Read the docs →
Book a demoStart free
Product
Wave GPUAI Infrastructure Professional ServiceWaveWave AI Agent2026 Q4
Resources
DocsAPI ReferenceBlogConsole DemoPricing
Company
STCLabBook a demoContact
STCLab© 2026 Wave All rights reserved.
Terms of ServicePrivacy PolicyCookies