title: Apache Mesos - Configuration layout: documentation

Mesos Configuration

The Mesos master and agent can take a variety of configuration options through command-line arguments or environment variables. A list of the available options can be seen by running mesos-master --help or mesos-agent --help. Each option can be set in two ways:

  • By passing it to the binary using --option_name=value, either specifying the value directly, or specifying a file in which the value resides (--option_name=file://path/to/file). The path can be absolute or relative to the current working directory.

  • By setting the environment variable MESOS_OPTION_NAME (the option name with a MESOS_ prefix added to it).

Configuration values are searched for first in the environment, then on the command-line.

Important Options

If you have special compilation requirements, please refer to ./configure --help when configuring Mesos. Additionally, this documentation lists only a recent snapshot of the options in Mesos. A definitive source for which flags your version of Mesos supports can be found by running the binary with the flag --help, for example mesos-master --help.

Master and Agent Options

These options can be supplied to both masters and agents.

These logging options can also be supplied to both masters and agents. For more about logging, see the logging documentation.

Master Options

Required Flags

Optional Flags

Flags available when configured with --with-network-isolator

Agent Options

Required Flags

Optional Flags

Directory for the fetcher cache. The agent will clear this directory on startup. It is recommended to set this value to a separate volume for several reasons:

Flags available when configured with --with-network-isolator

XFS disk isolator flags available when configured with --enable-xfs-disk-isolator

Libprocess Options

The bundled libprocess library can be controlled with the following environment variables.

Mesos Autotools Build Configuration Options

Autotools configure script options

Autotools configure script optional package flags

Environment variables which affect the Autotools configure script

Use these variables to override the choices made by configure or to help it to find libraries and programs with nonstandard names/locations.