---
name: "mfsgui.cfg"
section: "5"
platform: "linux"
package: "moosefs"
version: "4.59.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/mfsgui.cfg"
---

# mfsgui.cfg(5)

main configuration file for mfsgui

## 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)](/mfsgui/8.md)