Skip to content

Instantly share code, notes, and snippets.

@ryuheechul
Created August 15, 2025 18:34
Show Gist options
  • Save ryuheechul/c58fcfe44ffbdd1d837b4161f4170c3d to your computer and use it in GitHub Desktop.
Save ryuheechul/c58fcfe44ffbdd1d837b4161f4170c3d to your computer and use it in GitHub Desktop.
Installing csi-driver-smb on k8s cluster

It's a note on how to install csi-driver-smb on a Kubernetes cluster.

Either Way to Install

A) Via Rancher

If you use Rancher and prefer the GUI way, based on the article (also linked from the project itself) and the values below;

https://www.phillipsj.net/posts/how-to-use-the-windows-csi-proxy-and-csi-smb-driver-for-kubernetes/

Name: csi-driver-smb whatever you want though
URL: https://raw.githubusercontent.com/kubernetes-csi/csi-driver-smb/master/charts

I created a minimal video walkthrough on that below.

Screen.Recording.2025-08-15.at.10.30.43.AM.mp4

B) Via Helm

If you prefer to install via helm CLI instead, here is the way.

The command below basically follows https://github.com/kubernetes-csi/csi-driver-smb/tree/master/charts.

helm repo add csi-driver-smb https://raw.githubusercontent.com/kubernetes-csi/csi-driver-smb/master/charts
helm install csi-driver-smb csi-driver-smb/csi-driver-smb --namespace kube-system --version v1.18.0

Verify

Once the driver is installed there are some steps to verify its functionality.

First, install a SMB server on the cluster (for testing).

https://github.com/kubernetes-csi/csi-driver-smb/tree/master/deploy/example/smb-provisioner

Secondly, create PV (same creds from SMB server can be used) and Deployment following this guide below.

https://github.com/kubernetes-csi/csi-driver-smb/blob/master/deploy/example/e2e_usage.md#option2-pvpvc-usage

Lastly enter into the shell of the nginx container from the Deployment and interact with mounted directory /mnt/smb. Such as creating and deleting files.

The image stated may fail with pulling, in that case simply changing it to nginx image would work.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment