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.

  • Drivers
  • Plugins
  • Tools & Utilities
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

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

Collected 48 days ago - public community threads