SMB CSI Driver for Kubernetes
March 20, 2026 ยท View on GitHub
About
This driver allows Kubernetes to access SMB server on both Linux and Windows nodes. The driver requires an existing and already configured SMB server. It supports dynamic provisioning of Persistent Volumes via Persistent Volume Claims by creating a new sub directory under the SMB server.
- CSI plugin name:
smb.csi.k8s.io - Project status: GA
Container Images & Kubernetes Compatibility
| Driver Version | Supported K8s Version | Supported Windows CSI Proxy Version |
|---|---|---|
| master branch | 1.21+ | v0.2.2+ |
| v1.20.1 | 1.21+ | v0.2.2+ |
| v1.19.1 | 1.21+ | v0.2.2+ |
| v1.18.0 | 1.21+ | v0.2.2+ |
Driver Parameters
Please refer to smb.csi.k8s.io driver parameters.
Installation
Install the driver on a Kubernetes cluster:
- Install by Helm charts
- Install by kubectl
Examples
- Basic usage
- Set up a Samba Server on a Kubernetes cluster
- Windows
- Volume cloning
- How to Use the Windows CSI Proxy and CSI SMB Driver for Kubernetes
Troubleshooting
Development
Please refer to the development guide.
CI Results
- TestGrid sig-storage-csi-smb dashboard.
- Driver image build pipeline: post-csi-driver-smb-push-images