Storage

kubestart clusters support persistent storage through standard Kubernetes PersistentVolumeClaims (PVCs).

Storage quotas

The total storage and number of PVCs you can create depends on your package:

Package	Total storage	Max PVCs
Small	40 GiB	4
Medium	120 GiB	10
Large	320 GiB	20

Minimum volume size

The minimum PVC size is 10 GiB. Requests for smaller volumes are rejected.

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: my-data
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi  # Minimum allowed size

Deletion protection

To prevent accidental data loss, PVCs require an explicit annotation before they can be deleted:

metadata:
  annotations:
    storage.kubestart.io/confirm-delete: "true"

Without this annotation, kubectl delete pvc will be rejected. To delete a PVC:

kubectl annotate pvc my-data storage.kubestart.io/confirm-delete=true
kubectl delete pvc my-data

Caution

Deleting a PVC permanently destroys its data. This cannot be undone. The annotation requirement exists to make sure deletions are intentional.

Storage classes

Storage classes from the underlying infrastructure are available automatically. You do not need to create your own. Use the default storage class unless you have a specific reason to choose another:

kubectl get storageclass

Related

• Resource Quotas — full quota breakdown by package.