manpages

mfsgui.cfg(5)

mfsgui.cfg(5) This is part of MooseFS mfsgui.cfg(5)

NAME

mfsgui.cfg - main configuration file for mfsgui

DESCRIPTION

The file mfsgui.cfg contains configuration of MooseFS GUI server process.

SYNTAX

Syntax is:

OPTION = VALUE

Lines starting with # character are ignored as comments.

STARTUP OPTIONS

Changes in this section require process restart.

WORKING_USER
user to run daemon as
WORKING_GROUP
group to run daemon as; optional value - if empty then default user group will be used
SYSLOG_IDENT
name of process to place in syslog messages; default is mfsgui
LOCK_MEMORY
whether to perform mlockall() to avoid swapping out mfsgui process; default is 0, i.e. no
DISABLE_OOM_KILLER
disable out of memory killer (Linux only, default is 1)
NICE_LEVEL
nice level to run daemon with; default is -19; note: process must be started as root to increase priority, if setting of priority fails, process retains the nice level it started with
FILE_UMASK
set default umask for group and others (user has always 0); default is 027 - block write for group and block all for others
DATA_PATH
where to store daemon lock file

RUNTIME OPTIONS

Changes in this section require only process reload.

SYSLOG_MIN_LEVEL
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 level lower than set by 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 will be sent to syslog as NOTICE ; default is NOTICE)

CONNECTION OPTIONS

Changes in this section require only process reload.

GUISERV_LISTEN_HOST
IP address to listen on for incoming http connections (* means any)
GUISERV_LISTEN_PORT
port to listen on for incoming http connections
GUISERV_TIMEOUT
http connection timeout, in seconds (default is 300)

HTTP SERVER OPTIONS

Changes in this section require only process reload.

ROOT_DIR
document root for http server
REQUESTS_FILE
requests configuration file, absolute path or path relative to the ROOT_DIR; the content of this file should NEVER be modified by the user

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

mfsgui(8)

May 2026 MooseFS 4.59.2-1