mfsgui.cfg(5)

📦
version 4.59.2 · 2 versions
, in arch rolling, nixos 26.05, nixpkgs unstable, ubuntu stonking

💖 mfsgui.cfg(5) 💖

okay bestie, welcome to mfsgui.cfg — the main configuration file for mfsgui. yes this is section 5 of the manual, and yes it's part of MooseFS, and yes we're gonna get you fully caught up. 🫶

✨ NAME ✨

mfsgui.cfg — the main config file for mfsgui. that's the whole name, no notes, periodt.

🌸 DESCRIPTION 🌸

so the file mfsgui.cfg holds the configuration for the MooseFS GUI server process. that's it, that's the vibe. everything your GUI server needs to know about itself lives in here. 👑

🎀 SYNTAX 🎀

the syntax is literally this and nothing more:

OPTION = VALUE

and lines that start with the # character? ignored. comments. ghosts. not real. we don't see them. 💅

🚀 STARTUP OPTIONS 🚀

heads up babe: changes in this section require a process restart. not a reload. a whole restart. plan accordingly. 😭
  • WORKING_USER — the user we run the daemon as. that's their whole job fr.
  • WORKING_GROUP — the group we run the daemon as. it's optional! if it's empty, the default user group gets used instead. low maintenance icon. ✨
  • SYSLOG_IDENT — the name of the process that shows up in syslog messages. default is mfsgui.
  • LOCK_MEMORY — do we perform mlockall() to keep the mfsgui process from getting swapped out? default is 0, i.e. no. she stays in RAM or she doesn't, your call.
  • DISABLE_OOM_KILLER — disables the out of memory killer. Linux only, default is 1. (yes default is "disable the thing", slay.)
  • NICE_LEVEL — the nice level to run the daemon with. default is -19. note: the process must be started as root to increase priority, and if setting the priority fails, the process just retains the nice level it started with. no biggie, she keeps the fit she showed up in. 💅
  • FILE_UMASK — sets the default umask for group and others (user always has 0). default is 027 — block write for group and block all for others. protective queen behavior.
  • DATA_PATH — where to store the daemon lock file. that's the address, bestie.

🔄 RUNTIME OPTIONS 🔄

good news: changes in this section only require a process reload. much chiller. 🧚
  • SYSLOG_MIN_LEVEL — the minimum level of messages that will be reported by chunkserver. levels in order of importance: ERROR, WARNING, NOTICE, INFO, DEBUG. default is INFO.
  • SYSLOG_ELEVATE_TO — reported messages of a level lower than this option will be elevated to this level. i.e. if SYSLOG_MIN_LEVEL is set to DEBUG and SYSLOG_ELEVATE_TO is set to NOTICE, all INFO and DEBUG messages get sent to syslog as NOTICE. default is NOTICE. it's giving ✨promotion✨.

🌈 CONNECTION OPTIONS 🌈

also just a process reload for these. we love a low-effort change. 🦋
  • GUISERV_LISTEN_HOST — the IP address to listen on for incoming http connections (* means any). come one, come all.
  • GUISERV_LISTEN_PORT — the port to listen on for incoming http connections. the door. the entrance. 🚪
  • GUISERV_TIMEOUT — http connection timeout, in seconds. default is 300.

💜 HTTP SERVER OPTIONS 💜

yep, process reload for this section too. consistency is iconic. ⭐
  • ROOT_DIR — document root for the http server.
  • REQUESTS_FILE — requests configuration file, either an absolute path or a path relative to the ROOT_DIR.
⚠️ NOT ME SAYING THIS TWICE: the content of this file should NEVER be modified by the user. NEVER. like, capital letters, underlined, circled in hot pink. hands off. 🙈

Copyright (C) 2026 Jakub Kruszona-Zawadzki, Saglabs SA

This file is part of MooseFS.

MooseFS 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 2 (only).

MooseFS 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 this program; if not, see <https://www.gnu.org/licenses/>.

🔍 SEE ALSO 🔍

okay that's the whole page bestie, you ate that. this was MooseFS 4.59.2-1, dated May 2026 — go forth and configure responsibly, mwah 💖✨

📦 where this page comes from