mfsgui(8)

💖 mfsgui — the MooseFS GUI server, bestie edition 💖

okay so real talk: mfsgui is the MooseFS GUI server. She starts, she restarts, she stops — all the main character moves. This is part of MooseFS, and she's here to give you ✨web interface✨ energy.

---

🦋 SYNOPSIS 🦋

mfsgui [-c CFGFILE] [-f] [-d] [-u] [-n] [-t LOCKTIMEOUT] [ACTION]

mfsgui -v

mfsgui -h

---

🌸 DESCRIPTION 🌸

So mfsgui is literally the MooseFS GUI server, and she's built from two things: an HTTP server and a whole lil family of scripts that together make up the GUI interface to MooseFS. 🫶

The way you actually use her? You open any web browser and point it at the IP (or whatever domain name is giving) and the port that's defined in mfsgui.cfg. That's it. That's the vibe. Browser goes in, GUI comes out. 🎀

---

✨ OPTIONS ✨

• -v — print version information and bounce, that's it, that's the whole task 💅
• -h — print usage information and dip ✌️
• -c CFGFILE — point her at an alternative path for the configuration file (default is mfsgui.cfg in the system configuration directory)
• -f — run in the foreground, do not daemonize — she stays right there with you, no vanishing act
• -d — run with dangerous options (the ones with names like DANGEROUS_*) 😭 ok so this is literally the danger flag, tread carefully bestie
• -u — log undefined configuration values (y'know, when the default is just being assumed)
• -n — do not attempt to increase the limit of core dump size, we're leaving that limit alone
• -t LOCKTIMEOUT — how long to wait for the lockfile, in seconds (default is 60 seconds — one full minute of patience ⏳)

---

👑 ACTION 👑

so ACTION tells the MooseFS GUI server to do one of these things, and you just pick one like it's a menu (because it literally is):

• start — Start the MooseFS GUI server process, but only if the process isn't already running. If she's already up? You get an error message. no doubles, we respect the exclusivity 🙈
• stop — Stop the MooseFS GUI server process, but only if the process is running. If she isn't running? Error message, sorry babe 😭
• restart — (the default action!!) If the MooseFS GUI server process is running, restart it; if it's not running, start it. She's flexible, she reads the room 🌈
• reload — Send a signal to the MooseFS GUI server process to reload the config files. glow up, but for configs ✨
• info — Send a signal to the MooseFS GUI server process to dump a debug information file in the working directory 📝
• test — Displays mfsgui pid: PID if the MooseFS GUI server is running (and returns 0), or mfsgui is not running otherwise (and returns 1). it's giving vibe check, honestly 💀
• kill — Send a termination signal to the MooseFS GUI server process. bye bestie 🫶
• restore — Not implemented. that's the whole tea, she's just not there yet 🍓

---

🧚 FILES 🧚

• mfsgui.cfg — the configuration file for the MooseFS GUI server process; go check out mfsgui.cfg(5) for the details, iykyk
• .mfsgui.lock — the lock file of the running MooseFS GUI server process (created in the data directory) 🔒
• scripts — the various python, javascript, and other (static) files used to serve the GUI interface via HTTP; these files get installed into whatever directory is the default at installation time for ROOT_DIR in mfsgui.cfg 💖

---

😭 REPORTING BUGS 😭

Found a bug? Report it to <bugs@moosefs.com>. spill the tea, they'll handle it.

---

🌈 COPYRIGHT 🌈

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 🦋

mfsmaster(8), mfsgui.cfg(5)

go read those too, they're literally iconic 👑

---

MooseFS 4.59.2-1, dated May 2026 — that's the version and the date bestie, and that's a wrap 🎀✨ slay, you now fully understand mfsgui. periodt. 💅