{"full_name":"trapexit/mergerfs","owner":"trapexit","name":"mergerfs","shard":"1","url":"https://github.com/trapexit/mergerfs","description":"a featureful union filesystem","homepage":"http://trapexit.github.io/mergerfs/","topics":["mergerfs","fuse","unionfs","aufs","plex","subsonic","kodi","xattr","mhddfs","filesystem","jbod","overlayfs","libfuse","datahoarding","jellyfin"],"tag_pages":["filesystem","fuse","jellyfin","kodi","plex"],"language":"C++","license":"NOASSERTION","avatar":"https://avatars.githubusercontent.com/u/197676?u=4acb1a9892eff6afd2ca2e8d90616b463e892139&v=4","created_at":"2014-03-24T15:43:21Z","pushed_at":"2026-11-15T00:27:20Z","metrics":{"stars":5957,"forks":227,"watchers":73,"issues":681,"prs":819,"releases":92,"issues_open":26,"issues_closed":655,"prs_open":3,"prs_closed":35,"prs_merged":781,"discussions":175},"growth":{"day":{"stars":3,"forks":0,"base_day":"2026-11-15"}},"history":{"dates":["2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[5948,5949,5949,5949,5953,5954,5957],"forks":[226,226,226,226,227,227,227],"watchers":[null,73,73,73,73,73,73],"issues_open":[null,25,25,25,26,27,26],"prs_open":[null,3,3,3,3,3,3]},"boards":{},"same_owner":[],"issues":[{"number":342,"title":"[Feature] On input/output error try next available mount","comments":26,"created_at":"2016-12-07T07:40:43Z"},{"number":862,"title":"filename / filepath policy branch filters","comments":20,"created_at":"2021-01-07T15:07:06Z"},{"number":847,"title":"writing redundantly","comments":20,"created_at":"2020-12-03T19:00:34Z"},{"number":1607,"title":"NFS xattr regression with mergerfs after upgrade to kernel 6.15.11","comments":15,"created_at":"2026-01-11T22:51:56Z"},{"number":1589,"title":"NFS exporting mergerfs with a mix of RO and RW mounts and func.readdir=cor will randomly list the same file twice","comments":15,"created_at":"2025-11-23T11:07:05Z"},{"number":1332,"title":"fluctuating write performance","comments":13,"created_at":"2024-05-02T10:27:50Z"},{"number":1347,"title":"Mergerfs mount not responsive intermittently","comments":9,"created_at":"2024-07-24T10:14:22Z"},{"number":1468,"title":"Segfault: Race condition in concurrent cache operations with high thread counts","comments":8,"created_at":"2025-05-23T17:00:06Z"}],"discussions":[{"number":1673,"title":"Performance / CPU usage issue(?)","comments":1,"category":"Q&A","created_at":"2026-06-29T13:03:36Z"},{"number":1665,"title":"Exclude specific file or folder from mergerFS pool?","comments":1,"category":"Q&A","created_at":"2026-05-11T11:15:54Z"},{"number":1622,"title":"Drive not mounting into pool","comments":1,"category":"Q&A","created_at":"2026-03-09T22:02:20Z"},{"number":1615,"title":"File path selection based on newest inode","comments":1,"category":"Q&A","created_at":"2026-02-10T11:02:35Z"},{"number":1611,"title":"Is it possible to reserve space on disks?","comments":2,"category":"Q&A","created_at":"2026-01-21T21:40:23Z"},{"number":1608,"title":"Compatibility with Opencloud - anything in mergerfs options?","comments":1,"category":"General","created_at":"2026-01-13T18:31:32Z"},{"number":1602,"title":"Container volumes with ID Maps mounted in a merged directory","comments":1,"category":"General","created_at":"2025-12-13T19:52:14Z"},{"number":1599,"title":"Description of pfrd in the docs","comments":1,"category":"Q&A","created_at":"2025-12-09T19:05:06Z"}],"latest_release":{"name":"mergerfs v2.42.0","tag":"2.42.0","published_at":"2026-05-08T15:28:26Z","body":"# mergerfs v2.42.0\r\n\r\n## Donations / Sponsorship\r\n\r\nIf you find mergerfs useful please consider supporting its ongoing development.\r\n\r\nhttps://github.com/trapexit/support\r\n\r\n## New features\r\n\r\n* `lup` (least used percentage) policy: selects the branch with the lowest used space percentage.\r\n* `mount.mergerfs` now includes the `-n` flag to support mounting without updating /etc/mtab.\r\n\r\n## Improvements\r\n\r\n* Better lock management and behavior with open files. Reduction of contention.\r\n* Custom filename dedup strategy improving directory reading performance\r\n* Pre-calculate part of the file inode within readdir significantly reducing cost of overall calculation.\r\n* Replace sched_yield with nanosleep for improved scheduling of contention situations.\r\n* improved stat auto cache fingerprinting to reduce stale reads.\r\n\r\n## Behavior changes\r\n\r\n* credential handling reworked to be compatible with chroot and idmap. removed ability to disable `default_permissions` option as a result as mergerfs now requires the kernel to manage entitlements.\r\n* broken mounts with ENOTCONN (common due to crashed FUSE instances) are automatically unmounted if possible on start instead of hard erroring. (mostly useful while developing).\r\n* `fusermount3` will be used if available and other options missing.\r\n* `remember-nodes` option is deprecated and the feature removed. There is now only `never-forget-nodes` behavior. Any non-zero value in `remember-nodes` will enable `never-forget-nodes`. It was removed because time based really didn't save much memory and complicated the code. Doing this also reduced the size of each node helping offset increased node count.\r\n\r\n## Bug fixes\r\n\r\n* fix race condition between runtime changing of branches and certain requests.\r\n* `rmdir` no longer returns success if any rmdir call returns ENOTEMPTY.\r\n* Invalid policy names are properly rejected.\r\n* statfs calculation could theoretically have overflowed with impossibly large branch values.\r\n* Fixed `readlink` buffer size management. The size does not include a nul terminating value.\r\n* Minor calculation bugs in `copy_file_range` and `futimens`.\r\n* `moveonenospc` no longer crashes when all destination branches are rejected. Returns ENOSPC.\r\n* Better / more proper error calculations in a number of functions.\r\n* rare ioctl call crash fixed\r\n\r\n## Hardening\r\n\r\n* many \"the kernel should never do this bug **just** in case\" enhancements\r\n\r\n## Full Changelog\r\n\r\nhttps://github.com/trapexit/mergerfs/compare/2.41.1...2.42.0-rc2\r\n\r\n","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}