SFSMETALOGGER.CFG(5)

📦
version 5.8.0 · 4 versions
, in ubuntu stonking

💖 SFSMETALOGGER.CFG(5) 💖

okay bestie, welcome to the sfsmetalogger.cfg manual page (that's the section 5 one, config files, we're fancy like that) 🎀

✨ NAME ✨

sfsmetalogger.cfg — the configuration file for sfsmetalogger, no cap 💅

🦋 DESCRIPTION 🦋

So sfsmetalogger.cfg is THE file that holds all the configuration for the SaunaFS metalogger process. Like, that's its whole job. It's the vibe-setting document for your metalogger, and honestly? iconic.

📝 SYNTAX 📝

The syntax goes a lil something like this:

OPTION = VALUE

And listen — any line that starts with the # character? Ignored. Completely. It's giving "not invited to the party." 🙈

👑 OPTIONS 👑

Okay here come the configuration options, and yes we're listing every single one because we don't skip, ever ✨

  • DATA_PATH — where to store metadata files. that's the spot, that's where the metadata lives 🏠
  • WORKING_USER — the user to run the daemon as
  • WORKING_GROUP — the group to run the daemon as. it's optional, so if it's empty then the default user group gets used, easy peasy 🌸
  • SYSLOG_IDENT — the name of the process to place in syslog messages (default is sfsmetalogger)
  • LOCK_MEMORY — whether to perform mlockall() to avoid swapping out the sfsmetalogger process (default is 0, i.e. no)
  • LIMIT_GLIBC_MALLOC_ARENAS — Linux only bestie 💻: limit glibc malloc arenas to the given value — this prevents using a huge amount of virtual memory. It can influence performance by reducing memory fragmentation and improving cache locality, but it may also lead to contention and reduced parallelism in multi-threaded applications. Use it in constrained memory environments; the recommended values are 4 or 8. (default is 0: disabled or let glibc decide)
  • NICE_LEVEL — nice level to run the daemon with (default is -19 if possible; note: the process must be started as root to increase priority 👀)
  • BACK_LOGS — number of metadata change log files (default is 50)
  • BACK_META_KEEP_PREVIOUS — number of previous metadata files to be kept (default is 3)
  • META_DOWNLOAD_FREQ — metadata download frequency in hours (default is 24, at most BACK_LOGS/2)
  • MASTER_HOST — address of the SaunaFS master host to connect with (default is sfsmaster)
  • MASTER_PORT — number of the SaunaFS master port to connect with (default is 9419)
  • MASTER_RECONNECTION_DELAY — delay in seconds before trying to reconnect to the master after a disconnection (default is 30)
  • MASTER_TIMEOUT — timeout (in seconds) for master connections (default is 60)
  • LOG_LEVEL — Setup logging. It uses the environment variable SAUNAFS_LOG_LEVEL or the config value LOG_LEVEL to determine the logging level. The valid log levels are:
    • trace
    • debug
    • info
    • warn or warning
    • err or error
    • crit or critical
    • off
  • TLS_CERT_FILE (EXPERIMENTAL) — Path to the TLS certificate file the metalogger will use for TLS connections (there is no default value).
  • TLS_KEY_FILE (EXPERIMENTAL) — Path to the TLS private key file the metalogger will use for TLS connections (there is no default value).
  • TLS_CA_CERT_FILE (EXPERIMENTAL) — Path to the trusted CA certificate which is used to authenticate the TLS connection (there is no default value).
⚠️ heads up babes: those three TLS_* ones are marked (EXPERIMENTAL) in the original, so tread carefully, and also they have no default value at all. not even one. 🫶

🐛 REPORTING BUGS 🐛

Found a bug? Don't suffer in silence, bestie. Report it to the GitHub repository https://github.com/leil-io/saunafs as an issue. we're listening, fr fr 💌

Copyright 2008-2009 Gemius SA

Copyright 2013-2019 Skytechnology sp. z o.o.

Copyright 2023-2024 Leil Storage OÜ

SaunaFS is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3.

SaunaFS is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with SaunaFS. If not, see http://www.gnu.org/licenses/.

👀 SEE ALSO 👀

and that's a wrap on the SFSMETALOGGER.CFG(5) page, dated 2026-07-29 — go forth, configure your metalogger, and slay 💅✨💖

📦 where this page comes from