Configuration

One of the main objectives of fabio is that you do not have to configure it to do its job.

If you run fabio next to a consul agent and your services are configured properly all you have to do is start it and forget about it.

By default fabio listens on port 9999 for HTTP traffic and uses consul on localhost:8500 as the default registry backend.

Depending on your environment or requirements you may want to configure additional listeners, different backends, enable metrics reporting or change other configuration parameters. For this, please check the well documented fabio.properties file.

Each property value can also be configured via a corresponding environment variable which has the dots replaced with underscores.

Starting with version 1.2 parameters can also be specified on the command line. Arguments are parsed in the following order:

• properties file
• environment variable
• command line argument

Example

# fabio.properties
metrics.target = stdout

# correspondig env var (no prefix)
metrics_target=stdout ./fabio

# env var with FABIO_ prefix (>= 1.2)
FABIO_metrics_target=stdout ./fabio

# env var with FABIO_ prefix (case-insensitive) (>= 1.2)
FABIO_METRICS_TARGET=stdout ./fabio

# command line argument (>= 1.2)
./fabio -metrics.target stdout