# democratic-csi/democratic-csi

csi storage for container orchestration systems

Repository: https://github.com/democratic-csi/democratic-csi
Canonical: https://ross.abutalabs.com/products/democratic-csi
Language: JavaScript
License: MIT
License Family: permissive
Topics: freenas, k8s, csi-driver, csi, kubernetes, ubuntu, truenas, nfs, iscsi, storage, zfs, zfsonlinux, centos, rhel, freebsd, debian
Last push: 2026-01-07T22:17:05+00:00

## Health v2 (maintenance only)
Score: 55/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 61, release rhythm 21, longevity 100
- inputs: {"age_days": 2477, "days_push": 238, "days_rel": 313, "gap_med": null, "n_releases_24m": 1}
- flags: prerelease_only
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1324, forks 126 (observed 2026-08-28T04:04:22.385011+00:00)

## What it is
democratic-csi implements the Container Storage Interface (CSI) spec to provide dynamic storage provisioning for container orchestration systems like Kubernetes. It offers multiple drivers for zfs-based storage systems (TrueNAS/FreeNAS, ZoL) sharing volumes over NFS, iSCSI, SMB, and NVMe-oF, plus a framework for developing new CSI drivers.

## Use cases
- provision persistent volumes in Kubernetes from TrueNAS
- dynamically create zfs datasets over NFS for k8s pods
- csi driver for iscsi storage on freenas
- snapshot and resize persistent volume claims on zfs
- use zfs on ubuntu as kubernetes storage backend
- provision node-local zfs zvols for kubernetes

## When to choose
- you run Kubernetes (or another orchestrator) against TrueNAS/FreeNAS or a zfs-on-linux server
- you need full CSI features like resizing, snapshots, and clones from zfs-backed storage
- you want a self-hosted alternative to cloud storage drivers

## When to avoid
- you use a cloud provider with managed CSI drivers (EBS, PD, etc.)
- your storage backend is not zfs-based or one of the supported systems
- you need a non-container storage solution

## Facets
- artifact type: service
- maturity: active
- function: deployment, container-orchestration
- domain: infrastructure-as-code, self-hosted
- platform: bsd, self-hosted
- tags: csi-driver, zfs, truenas, freenas, nfs, iscsi, smb, nvmeof, storage-provisioning, persistent-volumes, storage, containers, devops, kubernetes, docker, linux

## Member repositories
- democratic-csi/democratic-csi (main) score 55

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:22.385011+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:46:41.594376+00:00, confidence not recorded.
  - readme: https://github.com/democratic-csi/democratic-csi (fetched 2026-08-28T04:04:22.385011+00:00, sha c5038dad09fa)
- Data as of 2026-08-30T08:39:29.467469+00:00.