hieutdo/policyfs
hieutdo/policyfs has 56 GitHub stars and 3 forks. GitHot measured 0 in 7 days. Last checked 2026-11-15 15:37 UTC. Last push 2026-09-11.
Measured star growth
- in 24h
- Update delayed
- in 7 days
- 0
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Linux FUSE storage daemon with routing rules and SQLite metadata index.
Self-hostedREADME.md
OriginalPolicyFS
PolicyFS is a Linux FUSE storage daemon that unifies multiple storage paths under one mountpoint with explicit read/write routing rules, an optional SQLite metadata index, and built-in maintenance jobs.
What it does
- One mountpoint, many disks: merge multiple storage paths into a single POSIX-ish view.
- Routing rules: decide where reads/writes go based on path patterns.
- Spin-down friendly listings: keep HDDs asleep by serving metadata from an index (SQLite) for "indexed" paths.
- Deferred physical operations: for indexed paths, record DELETE/RENAME events and apply them later.
- Support-friendly debug logs: trace indexed read and deferred mutation flows without changing filesystem behavior.
Status
- Supported packaging today: Debian/Ubuntu + Fedora/EL9 (linux/amd64).
Docs
- User documentation: https://docs.policyfs.org/
Getting started
For the full step-by-step guide, see: https://docs.policyfs.org/getting-started/
Install runtime dependencies:
sudo apt-get update sudo apt-get install -y fuse3Install from the APT repo or download a
.debfrom GitHub Releases.Edit the config:
/etc/pfs/pfs.yaml(created from the example on first install)
Start a mount:
sudo systemctl enable --now [email protected]Run the indexer (optional, but recommended for indexed paths):
sudo systemctl start [email protected]
Contributing
If you want to contribute, keep PRs small and behavior-focused.
The development environment uses Docker Compose so you can work on macOS/Windows while running Linux FUSE inside the container.
Start dev environment:
make dev # Start this worktree's dev container
Each Git worktree gets an isolated Compose project, cache volumes, virtual disks, and dynamically assigned localhost ports. Run make dev-ports to print the host ports for Delve and MkDocs.
Run tests:
make test-unit # Run unit tests in the dev container
make test-integration # Run integration tests in the dev container
make coverage # Generate coverage report for both unit and integration tests
Useful commands:
make dev-fresh # Start the dev container with a fresh state
make dev-shell # Open a shell in the dev container
make fmt # Format code
make lint # Lint code
make docs # Generate documentation
make docs-serve # Serve documentation
Before opening a PR:
- Ensure
make lintis clean. - Run the relevant tests (
make test-unitat minimum; addmake test-integrationfor filesystem behavior changes). - Run
make coverageto generate a coverage report for both unit and integration tests. - If you changed behavior or configuration, update the nearest relevant docs in
docs/.
License
Apache-2.0. See LICENSE.