Ceph CSI CephFS
Kubernetes Container Storage Interface (CSI) driver that exposes Ceph CephFS file systems as persistent volumes to workloads.
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
Variants
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
- Which block storage solution to self host ? : r/kubernetes - Reddit (reddit)
- Proxmox 9.0.5 Ceph 19.2.3 Kubernetes ceph-csi-cephfs Hang (forum)
- ceph - Reddit (reddit)
- CEPH Helm chart / CSI driver install - General - 45HomeLab Forum (forum)
- Deploying CEPH CSI and on K8s using HELM and YAML (forum)
Collected 48 days ago - public community threads