MergerFS for UNRAID
A UNRAID plugin that installs mergerFS and mergerFS-Tools to combine multiple storage devices into a single filesystem for simpler file management.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- 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.
46/100 Fair
- Maintained
- 76last commit 35 days ago
- Popular
- 165 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, links checked 4 days ago
- GitHub stars
- 5
- Open issues
- 0
- Last commit
- 2026-10-17
- License
- GPL-2.0
- Activity
- stale
Checked today - source: GitHub (desertwitch/mergerFS-unRAID)
Resources & Compatibility
Requirements not published yet.
First-install notes
- Point mergerfs at your media folders Run mergerfs with the exact folders you want to combine plus the single folder where apps should read and write. If the destination folder already has files, allow non-empty mounts or mergerfs can refuse to start and your media may not appear. source
- Start mergerfs only after disks mount If you use a systemd service, tell it to wait for the drives to be mounted and for a short setup service to finish. Without that wait, mergerfs can start too soon and fail to see one or more drives, so mounts break or apps miss folders. source
- End of support on 30 Nov 2026 The developer announced that support for this plugin ends on 30.11.2026. After that date it stays installable but with no stability or usability guarantee, and the repository will be archived; if a future Unraid release breaks the plugin, installs on newer versions may be capped. source
Fetched today - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
When pointing mergerFS at existing folders, why might it refuse to start?
If the destination folder already contains files, allow non-empty mounts. Otherwise mergerFS can refuse to start and media may not appear.
What boot-order issue can cause mergerFS mounts to break?
mergerFS can start too soon and fail to see one or more drives if it does not wait for the drives to mount. If using a systemd service, tell it to wait for the drives and a short setup service to finish.
How does mergerFS choose which branch to use for a new file?
It uses policies such as first found, which picks the first branch, and rand, which chooses randomly. For example, category.create=ff makes file creation use the first branch found.
Can apps keep a file open while I sync or move data between merged folders?
Open files are not a problem because deleted files are removed when their count goes to 0. A new open can find the new copy on a slower disk while rsync is running.
Does the Unraid plugin include helper tools?
The plugin installs mergerFS and includes mergerFS-Tools. It can be installed from Community Apps on the Unraid server.
Answers sourced from ca.unraid.net, forums.unraid.net, github.com, github.com, www.reddit.com
Community
- [PLUGIN] mergerFS for UNRAID (Support Topic) (forum)
- Tiered storage with mergerfs. Anyone using it? Any recommended ... - Reddit (reddit)
- Setting up mergerfs : r/unRAID - Reddit (reddit)
- [PLUGIN] mergerFS for UNRAID (Support Topic) (forum)
- Two UnRAID Boxes - Combine with MergerFS? : r/unRAID - Reddit (reddit)
Collected 48 days ago - public community threads