Storage

Uncloud provides two types of storage: Block Storage (volumes) for attaching disks to Droplets and Object Storage (buckets) for S3-compatible file storage.

Block Storage (Volumes)

Volumes are high-performance block devices that attach to Droplets. Each volume is backed by a Kubernetes PersistentVolumeClaim using Rook/Ceph RBD or Longhorn.

Volume Lifecycle

Status	Description
`creating`	Volume is being provisioned
`available`	Ready to attach to a Droplet
`attached`	Mounted to a Droplet
`deleting`	Being removed

Features

Attach/Detach — Mount a volume to any Droplet in the same project
Resize — Increase volume size (no shrinking)
Snapshots — Create point-in-time copies
Multiple sizes — From 1 GB to multiple TB

Example

# Create a 50GB volume
POST /api/v1/volumes
{
  "name": "data-volume",
  "size_gb": 50,
  "region": "nyc1"
}

Object Storage (Buckets)

S3-compatible object storage for files, backups, media, and static assets. Powered by Rook/Ceph RGW or MinIO.

Features

S3-Compatible API — Works with any S3 client or SDK
Buckets — Create isolated containers for objects
Pre-signed URLs — Generate temporary access links for uploads/downloads
File Browser — Browse and manage objects from the dashboard

Example

# Create a bucket
POST /api/v1/storage/buckets
{ "name": "my-assets" }

# Upload an object
POST /api/v1/storage/buckets/my-assets/objects
# (multipart form upload)

# Generate pre-signed URL
POST /api/v1/storage/buckets/my-assets/objects/presign
{ "key": "images/photo.jpg", "expires_in": 3600 }

Storage Classes

Uncloud uses Kubernetes StorageClasses to provision volumes. The default class is configured during the admin setup:

Storage Class	Backend	Use Case
`ceph-rbd`	Rook/Ceph	High-performance block storage
`longhorn`	Longhorn	Simple, replicated storage
`local-path`	Local	Development/testing only

Kubernetes Mapping

Storage Concept	Kubernetes Resource
Volume	`PersistentVolumeClaim`
Volume snapshot	`VolumeSnapshot`
Bucket	S3 API (Ceph RGW/MinIO)
Storage class	`StorageClass`

Getting Started

Core Concepts

Block Storage (Volumes)

Volume Lifecycle

Features

Example

Object Storage (Buckets)

Features

Example

Storage Classes

Kubernetes Mapping

​Block Storage (Volumes)

​Volume Lifecycle

​Features

​Example

​Object Storage (Buckets)

​Features

​Example

​Storage Classes

​Kubernetes Mapping

Block Storage (Volumes)

Volume Lifecycle

Features

Example

Object Storage (Buckets)

Features

Example

Storage Classes

Kubernetes Mapping