Ceph CSI CephFS

Kubernetes Container Storage Interface (CSI) driver that exposes Ceph CephFS file systems as persistent volumes to workloads.

  • Cloud
  • Infrastructure
  • Tools & Utilities
Kubernetes Container Storage Interface (CSI) driver that exposes Ceph CephFS file systems as persistent volumes to workloads. It provisions, attaches, snapshots, and resizes CephFS storage so anyone running Ceph and Kubernetes in a home lab can mount shared files into applications.

Platform availability

Available on 1 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

72/100 Good

Maintained
100last commit 15 days ago
Popular
641,582 GitHub stars
Easy to install
251 install platform, install notes
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today

GitHub stars
1,582
Open issues
138
Last commit
2026-11-06
Latest release
v3.18.2
License
Apache-2.0
Activity
steady

Checked 14 days ago - source: GitHub (ceph/ceph-csi)

Resources & Compatibility

Requirements not published yet.

First-install notes

  • Start Ceph services before using CephFS Make sure the Ceph background services (mon, osd, and mds) are started before you use ceph-csi-cephfs. MDS is the CephFS metadata service, and if it is stopped, the ceph-csi-cephfs plugin cannot provide a working file-system share. source
  • Installation Deploy the driver into Kubernetes with the ceph-csi-cephfs Helm chart. source

Fetched 2 days ago - each note links to its source

Alternatives (1)

  • GlusterFS - GlusterFS is a scale-out network-attached storage file system.

Checked 40 days ago - source: AlternativeTo

Common questions

How can I expose a Proxmox-backed CephFS mount to Kubernetes?

Install a Ceph CSI Helm chart to publish the Proxmox-backed CephFS mount points to Kubernetes.

What should I check when a CephFS PVC is stuck in Provisioning?

Check the Ceph cluster and network connectivity. If the problem is provisioning, restart the CephFS provisioner pod such as csi-cephfsplugin-provisioner.

What has been reported about ceph-csi-cephfs hanging on Proxmox with CephFS?

A Proxmox thread reports a hang when CephFS is used through Kubernetes and compares that behavior with CephFS mounted directly on the Proxmox host.

How should I back up a single-node CephFS cluster used with ceph-csi-cephfs?

Back up the Ceph cluster regularly using rbd export or rsync for CephFS. Losing the only monitor host can mean losing the cluster.

Answers sourced from forum.45homelab.com, forum.proxmox.com, github.com, www.reddit.com

Community

Collected 48 days ago - public community threads