erikmagkekse

erikmagkekse / btrfs-nfs-csi

Public

Kubernetes Enterprise storage vibes for your homelab. A single-binary CSI driver that turns any Linux box with a btrfs disk into a full-featured storage backend(Agent) - instant snapshots, writable clones, per-volume quotas, live compression tuning, NoCOW for databases, and automatic NFS exports.

28
0
100% credibility
Found Feb 24, 2026 at 16 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Go
AI Summary

A single-binary CSI driver enabling BTRFS-backed NFS storage for Kubernetes with snapshots, clones, quotas, compression, and a web dashboard.

How It Works

1
🏠 Discover simple storage solution

You hear about a tool that adds powerful file saving to your home server setup, with easy backups and resizing.

2
💾 Prepare your storage server

On your Linux computer with a special disk, you run a small program to manage files, snapshots, and shares.

3
🔗 Connect to your app cluster

You add the setup files to your main computer group so apps can request storage spaces.

4
📋 Set storage preferences

You pick options like size limits, compression, or special modes for your needs.

5
📦 Apps claim their file spaces

Your apps automatically get private, resizable folders over the network.

6
📸 Use magic features

Easily snapshot for backups, clone copies, expand space, and watch usage on a dashboard.

🎉 Perfect home storage

Your setup now has pro-level file management: safe, fast, and always monitored.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 16 to 28 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is btrfs-nfs-csi?

This Go-based CSI driver turns a Linux box with BTRFS into a Kubernetes storage backend(agent), delivering automatic NFS exports for pods. It provides instant snapshots, writable clones from snapshots, per-volume quotas, live compression tweaks like zstd levels, and NoCOW for databases--all without iSCSI or Ceph complexity. Ideal for homelabs mimicking enterprise kubernetes cluster storage on cheap hardware.

Why is it gaining traction?

Unlike heavyweight enterprise kubernetes platforms requiring Ceph clusters or pricey licenses, it deploys as a single binary with zero PhD needed, yet packs HA via DRBD and a web dashboard for monitoring volumes, exports, and usage. Developers love the automatic quota enforcement and Prometheus metrics integration, plus seamless Kubernetes github actions for CI/CD testing. The hook: full CSI spec support (expand, snapshot, clone) in a lightweight package that just works for RWX/RWO volumes.

Who should use this?

Homelab operators running k8s on Raspberry Pi or old servers needing reliable PVs with snapshots for backups. Small teams prototyping apps on kubernetes github runner or ingress-nginx setups, avoiding vendor lock-in from kubernetes enterprise support. Perfect for DB workloads demanding NoCOW and quotas without managing separate storage arrays.

Verdict

Grab it for homelab persistence if you're okay with early-stage rough edges--11 stars and 1.0% credibility score mean expect bugs, but solid docs and dev scripts ease testing. Pair with github kubernetes releases for quick iteration; production? Wait for NFS-Ganesha and LIST_VOLUMES polish.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.