# MergerFS for UNRAID

MergerFS for UNRAID is a self-hosted drivers app. A UNRAID plugin that installs mergerFS and mergerFS-Tools to combine multiple storage devices into a single filesystem for simpler file management. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/4134/mergerfs-for-unraid

## Description

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.

## Health score

46/100 (Fair), based on 3 of 4 factors.
- Maintained: 76 (last commit 35 days ago)
- Popular: 16 (5 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)

## Links

- Unraid: https://ca.unraid.net/apps/mergerfs-for-unraid-17ybq7l1qbgw1p?q=mergerFS%20for%20UNRAID
- GitHub: https://github.com/desertwitch/mergerFS-unRAID

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/4134/mergerfs-for-unraid), the self-hosted and open-source app directory.
