You are viewing the documentation for Pilosa v0.4. View the latest documentation for Pilosa v1.3.0.


Pilosa can be configured through command line flags, environment variables, and/or a configuration file; configured options take precedence in that order. So if an option is specified in a command line flag, it will take precedence over the same option specified in the environment, which would take precedence over that same option specified in the configuration file.

All options are available in all three configuration types with the exception of the --config option which specifies the location of the config file, and therefore will not be used if it is present in the config file.

The syntax for each option is slightly different between each of the configuration types, but follows a simple formula. See the following three sections for an explanation of each configuration type.

Command line flags

Pilosa uses GNU/POSIX style flags. Most flags you specify as --flagname=value although some have a short form that is a single character and can be specified with a single dash like -f value. Running pilosa server --help will give an overview of the available flags as well as their short forms (if applicable).

Environment variables

Every command line flag has a corresponding environment variable. The environment variable is the flag name in all caps, prefxed by PILOSA_, and with any dashes replaced by underscores. For example: --flag-name becomes PILOSA_FLAG_NAME.

Config file

The config file is in the toml format and has exactly the same options available as the flags and environment variables. Any flag which contains a dot (“.”) denotes nesting within the config file, so the two flags --cluster.poll-interval=2m0s and --cluster.replicas=1 look like this in the config file:

  poll-interval = "2m0s"
  replicas = 1

Any flag that has a value that is a comma separated list on the command line becomes an array in toml. For example, becomes:

  hosts = ["", ""]

All Options

Anti Entropy Interval


Cluster Hosts

Cluster Internal Hosts

Cluster Internal Port

Cluster Poll Interval

Cluster Replicas

Cluster Type

Data Dir

Profile CPU

Profile CPU Time

Metric Host
Metric Poll Interval

View markdown source on Github. Last updated 1 year, 8 months ago.