# Ceph CSI CephFS

Ceph CSI CephFS is a self-hosted cloud app. Kubernetes Container Storage Interface (CSI) driver that exposes Ceph CephFS file systems as persistent volumes to workloads. It is open source and self-hosted, installable on Kubernetes (Helm).

Canonical page: https://ourlocalhost.com/app/4755/ceph-csi-cephfs

## Description

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: Helm.

## Health score

72/100 (Good), based on 3 of 4 factors.
- Maintained: 100 (last commit 15 days ago)
- Popular: 64 (1,582 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)

## Links

- GitHub: https://github.com/ceph/ceph-csi
- Kubernetes (Helm): https://artifacthub.io/packages/helm/ceph-csi/ceph-csi-cephfs
- Documentation: https://ceph.github.io/ceph-csi

## 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.

## Alternatives

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

---
Source: Our Local Host (https://ourlocalhost.com/app/4755/ceph-csi-cephfs), the self-hosted and open-source app directory.
