mirror of
https://github.com/trapexit/mergerfs.git
synced 2025-05-20 05:42:35 +08:00
46 lines
2.2 KiB
Markdown
46 lines
2.2 KiB
Markdown
# Support
|
|
|
|
Filesystems are complex, as are the interactions software have with
|
|
them, and therefore difficult to debug. When reporting on a suspected
|
|
issue **please** include as much of the below information as possible
|
|
otherwise it will be difficult or impossible to diagnose. Also please
|
|
read the documentation as it provides details on many previously
|
|
encountered questions/issues.
|
|
|
|
**Please make sure you are using the [latest
|
|
release](https://github.com/trapexit/mergerfs/releases) or have tried
|
|
it in comparison. Old versions, which are often included in distros
|
|
like Debian and Ubuntu, are not ever going to be updated and the issue
|
|
you are encountering may have been addressed already.**
|
|
|
|
**For commercial support or feature requests please [contact me
|
|
directly.](mailto:support@spawn.link)**
|
|
|
|
### Information to include in bug reports
|
|
|
|
* [Information about the broader problem along with any attempted
|
|
solutions.](https://xyproblem.info)
|
|
* Solution already ruled out and why.
|
|
* Version of mergerfs: `mergerfs --version`
|
|
* mergerfs settings / arguments: from fstab, systemd unit, command
|
|
line, OMV plugin, etc.
|
|
* Version of the OS: `uname -a` and `lsb_release -a`
|
|
* List of branches, their filesystem types, sizes (before and after issue): `df -h`
|
|
* **All** information about the relevant paths and files: permissions, ownership, etc.
|
|
* **All** information about the client app making the requests: version, uid/gid
|
|
* Runtime environment:
|
|
* Is mergerfs running within a container?
|
|
* Are the client apps using mergerfs running in a container?
|
|
* A `strace` of the app having problems:
|
|
* `strace -fvTtt -s 256 -o /tmp/app.strace.txt <cmd>`
|
|
* A `strace` of mergerfs while the program is trying to do whatever it is failing to do:
|
|
* `strace -fvTtt -s 256 -p <mergerfsPID> -o /tmp/mergerfs.strace.txt`
|
|
* **Precise** directions on replicating the issue. Do not leave **anything** out.
|
|
* Try to recreate the problem in the simplest way using standard programs: `ln`, `mv`, `cp`, `ls`, `dd`, etc.
|
|
|
|
### Contact / Issue submission
|
|
|
|
* github.com: [https://github.com/trapexit/mergerfs/issues](https://github.com/trapexit/mergerfs/issues)
|
|
* discord: [https://discord.gg/MpAr69V](https://discord.gg/MpAr69V)
|
|
* reddit: [https://www.reddit.com/r/mergerfs](https://www.reddit.com/r/mergerfs)
|