trapexit
6 days ago
committed by
GitHub
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with
18 additions and
6 deletions
mkdocs/docs/config/options.md
mkdocs/docs/error_handling_and_logging.md
mkdocs/docs/media_and_publicity.md
@ -220,7 +220,10 @@ config file.
* **noforget** : Effectively sets `remember-nodes` to infinity.
* **noforget** : Effectively sets `remember-nodes` to infinity.
* **allow-idmap=BOOL** : Enables idmap (identity mapping). (default:
* **allow-idmap=BOOL** : Enables idmap (identity mapping). (default:
true)
true)
* **debug** : Enable debugging information. At the moment limited to a
FUSE message trace saved to `log.file` . (default: false)
* **log.file** : The file path for the FUSE message trace. Empty string
will set to stderr. (default: stderr)
**NOTE:** Options are evaluated in the order listed so if the options
**NOTE:** Options are evaluated in the order listed so if the options
are **func.rmdir=rand,category.action=ff** the **action** category
are **func.rmdir=rand,category.action=ff** the **action** category
@ -88,11 +88,18 @@ filesystems. Mainly `ext4`.
## Logging
## Logging
Filesystems, and therefore mergerfs, are doing lots of small actions
at high speed. It simply isn't reasonable to log all the actions of
the system. That said: certain details are logged at startup and when
performing maintenance tasks. These are logged via `syslog` and on
`systemd` based systems can be viewed by running
Filesystems, and therefore mergerfs, are doing **lots** of small
actions at high speed. It simply isn't reasonable to log all the
actions of the system all time time. However, there is a debug mode
which can be toggled on as needed, even at runtime, which will record
some information to help with debugging. The main thing it will record
is a trace of all FUSE messages to the location defined by the
`log.file` option. See [config section ](config/options.md ) for more
details.
That said even with debug mode disabled mergerfs will log certain
details via `syslog` which on `systemd` based systems can be viewed by
running:
```
```
journalctl -t mergerfs
journalctl -t mergerfs
@ -68,6 +68,8 @@
* 2025-04-23 - [How to build the Perfect Media Server | Part 1 - The Tech Stack | mergerfs, SnapRAID, and docker. ](https://www.youtube.com/watch?v=Yt67zz9p0FU )
* 2025-04-23 - [How to build the Perfect Media Server | Part 1 - The Tech Stack | mergerfs, SnapRAID, and docker. ](https://www.youtube.com/watch?v=Yt67zz9p0FU )
* 2025-06-12 - [DIY Unraid-like functionality ](https://www.youtube.com/watch?v=fR0XhaWvR1E )
* 2025-06-12 - [DIY Unraid-like functionality ](https://www.youtube.com/watch?v=fR0XhaWvR1E )
* 2025-09-22 - [استفاده از Snapraid و MergerFS | جایگزین RAID5 ](https://www.youtube.com/watch?v=GA6OvaUBKXs )
* 2025-09-22 - [استفاده از Snapraid و MergerFS | جایگزین RAID5 ](https://www.youtube.com/watch?v=GA6OvaUBKXs )
* 2026-02-10 - [Never run out of space again! Using MergerFS with Immich to expand your storage seamlessly ](https://www.youtube.com/watch?v=Vbu4WzWUikQ )
## Podcasts
## Podcasts