# kubernetes-csi/csi-driver-nfs

This driver allows Kubernetes to access NFS server on Linux node.

Repository: https://github.com/kubernetes-csi/csi-driver-nfs
Canonical: https://ross.abutalabs.com/products/csi-driver-nfs
Language: Go
License: Apache-2.0
License Family: permissive
Topics: k8s-sig-storage, nfs, csi, kubernetes
Last push: 2026-08-24T22:03:32+00:00

## Health v2 (maintenance only)
Score: 92/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 78, longevity 100
- inputs: {"age_days": 2906, "days_push": 9, "days_rel": 64, "gap_med": 60, "n_releases_24m": 10}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1312, forks 321 (observed 2026-08-28T04:04:20.132029+00:00)

## What it is
A Kubernetes CSI driver that lets clusters mount and dynamically provision persistent volumes from an existing NFSv3 or NFSv4 server. It creates subdirectories on the NFS server to back PersistentVolumeClaims and supports snapshots and volume cloning.

## Use cases
- dynamically provision persistent volumes from an NFS server in Kubernetes
- mount an existing NFS share as a Kubernetes PersistentVolume
- create subdirectory-backed PVCs on NFS storage
- take volume snapshots of NFS-backed persistent volumes
- clone NFS-backed persistent volumes
- use NFS storage with MicroK8s clusters

## When to choose
- your Kubernetes cluster needs persistent storage backed by an existing NFSv3 or NFSv4 server
- you want dynamic provisioning of PVCs on NFS without pre-creating volumes
- you need snapshots or cloning for NFS-backed volumes
- you want a GA-status, Kubernetes SIG-storage maintained driver

## When to avoid
- you have no NFS server already configured and reachable from your nodes
- you need block storage or local-disk performance rather than network file storage
- your cluster runs on Windows nodes, which this driver does not support
- you need a storage backend other than NFS (use a CSI driver for that backend)

## Facets
- artifact type: plugin
- maturity: stable
- function: container-orchestration, file-system
- domain: cloud-computing, infrastructure-as-code
- platform: go
- tags: csi-driver, nfs, persistent-volumes, kubernetes-storage, dynamic-provisioning, volume-snapshots, volume-cloning, storage, containers, devops, kubernetes, linux, docker

## Member repositories
- kubernetes-csi/csi-driver-nfs (main) score 92

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:20.132029+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:49:05.539228+00:00, confidence not recorded.
  - readme: https://github.com/kubernetes-csi/csi-driver-nfs (fetched 2026-08-28T04:04:20.132029+00:00, sha b7b335cac73c)
- Data as of 2026-08-30T08:39:29.467469+00:00.