kubernetes-csi/csi-driver-smb

This driver allows Kubernetes to access SMB Server on both Linux and Windows nodes.

668

stars

2,537

commits

Go

primary language

Sep 14, 2026

updated

k8s-sig-storage
kubernetes
smb
windows

README

SMB CSI Driver for Kubernetes

linux build status windows build status Coverage Status Artifact Hub

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 VersionSupported K8s VersionSupported Windows CSI Proxy Version
master branch1.21+v0.2.2+
v1.20.31.21+v0.2.2+
v1.19.11.21+v0.2.2+
v1.18.01.21+v0.2.2+

Driver Parameters

Please refer to smb.csi.k8s.io driver parameters.

Installation

Install the driver on a Kubernetes cluster:

Examples

Troubleshooting

Development

Please refer to the development guide.

CI Results

Contributors

(top 30 of 68)

andyzhangx

1,820 commits

k8s-ci-robot

285 commits

dependabot[bot]

86 commits

chewong

52 commits

kubernetes-csi/csi-driver-smb

This driver allows Kubernetes to access SMB Server on both Linux and Windows nodes.

668

stars

2,537

commits

Go

primary language

Sep 14, 2026

updated

k8s-sig-storage
kubernetes
smb
windows

README

SMB CSI Driver for Kubernetes

linux build status windows build status Coverage Status Artifact Hub

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 VersionSupported K8s VersionSupported Windows CSI Proxy Version
master branch1.21+v0.2.2+
v1.20.31.21+v0.2.2+
v1.19.11.21+v0.2.2+
v1.18.01.21+v0.2.2+

Driver Parameters

Please refer to smb.csi.k8s.io driver parameters.

Installation

Install the driver on a Kubernetes cluster:

Examples

Troubleshooting

Development

Please refer to the development guide.

CI Results

Contributors

(top 30 of 68)

andyzhangx

1,820 commits

k8s-ci-robot

285 commits

dependabot[bot]

86 commits

chewong

52 commits

Languages

Go

65.3%

Shell

23.7%

Makefile

4.0%

Mustache

3.8%

Python

3.1%