ScyllaDB University Live | Free Virtual Training Event
Learn more
ScyllaDB Documentation Logo Documentation
  • Server
  • Cloud
  • Tools
    • ScyllaDB Manager
    • ScyllaDB Monitoring Stack
    • ScyllaDB Operator
  • Drivers
    • CQL Drivers
    • DynamoDB Drivers
  • Resources
    • ScyllaDB University
    • Community Forum
    • Tutorials
Download
ScyllaDB Docs Scylla Operator Architecture Storage Overview

Caution

You're viewing documentation for a previous version of Scylla Operator. Switch to the latest stable version.

Overview¶

ScyllaDB works with both local and network attached storage provisioners, but our primary focus is around the local storage that can provide the best performance. We support using 2 local provisioners: ScyllaDB Local CSI Driver and Kubernetes SIG Storage Local Persistence Volume Static Provisioner.

Setting up local disks¶

When a Kubernetes node having local disk(s) is created, the storage is usually uninitialized. This heavily depends on your platform and its options, but even when provisioned with mounted disks, they usually don’t set up RAID, nor have the option to choose a file system type. (ScyllaDB needs the storage to be formatted with xfs.)

Setting up the RAID arrays, formatting the file system or mounting it in a declarative manner is challenging and that’s one of the reasons we have created the NodeConfig custom resource.

Supported local provisioners¶

ScyllaDB Local CSI driver¶

ScyllaDB Local CSI Driver supports dynamic provisioning on local disks and sharing the storage capacity. It is based on dynamic directories and xfs prjquota. It allows PersistentVolumes to be created dynamically for a corresponding PersistentVolumeClaim by automatically provisioning directories created on disks attached to instances. On supported filesystems, directories have quota limitations to ensure volume size limits.

At this point, the Local CSI Driver doesn’t support provisioning block devices.

Kubernetes SIG Storage Static Local Volume Provisioner¶

The local volume static provisioner is a Kubernetes SIG Storage project that can turn your disks into dedicated and isolated PersistentVolumes but all of them have to be created manually.

Was this page helpful?

PREVIOUS
Storage
NEXT
Local CSI Driver
  • Create an issue
  • Edit this page

On this page

  • Overview
    • Setting up local disks
    • Supported local provisioners
      • ScyllaDB Local CSI driver
      • Kubernetes SIG Storage Static Local Volume Provisioner
Scylla Operator
  • v1.15
    • v1.17
    • v1.16
    • v1.15
    • master
  • Architecture
    • Overview
    • Storage
      • Overview
      • Local CSI Driver
    • Tuning
    • ScyllaDB Manager
  • Installation
    • Overview
    • Kubernetes
      • Generic
      • EKS
      • GKE
    • GitOps (kubectl)
    • Helm
  • Resources
    • Overview
    • ScyllaClusters
      • ScyllaClusters
      • ScyllaDB clients
        • Discovering ScyllaDB Nodes
        • Using CQL
        • Using Alternator (DynamoDB)
      • Node operations using Scylla Operator
        • Upgrading version of Scylla
        • Replacing a Scylla node
        • Automatic cleanup and replacement in case when k8s node is lost
        • Maintenance mode
        • Restore from backup
      • Deploying multi-datacenter ScyllaDB clusters in Kubernetes
        • Build multiple Amazon EKS clusters with inter-Kubernetes networking
        • Build multiple GKE clusters with inter-Kubernetes networking
        • Deploy a multi-datacenter ScyllaDB cluster in multiple interconnected Kubernetes clusters
      • Exposing ScyllaCluster
    • ScyllaDBMonitorings
    • NodeConfigs
    • ScyllaOperatorConfigs
  • Quickstarts
    • Deploying ScyllaDB on GKE
    • Deploying ScyllaDB on EKS
  • Support
    • Support overview
    • Known issues
    • Troubleshooting
      • Troubleshooting installation issues
    • Gathering data with must-gather
    • Releases
  • API Reference
    • scylla.scylladb.com
      • NodeConfig (scylla.scylladb.com/v1alpha1)
      • ScyllaCluster (scylla.scylladb.com/v1)
      • ScyllaDBDatacenter (scylla.scylladb.com/v1alpha1)
      • ScyllaDBMonitoring (scylla.scylladb.com/v1alpha1)
      • ScyllaOperatorConfig (scylla.scylladb.com/v1alpha1)
Docs Tutorials University Contact Us About Us
© 2025, ScyllaDB. All rights reserved. | Terms of Service | Privacy Policy | ScyllaDB, and ScyllaDB Cloud, are registered trademarks of ScyllaDB, Inc.
Last updated on 14 July 2025.
Powered by Sphinx 8.1.3 & ScyllaDB Theme 1.8.6