<commit_before>4.1 Configuration File
=====================

Configuration files aren't mandatory but they provide a convenient way to specifiy regularly used options, so you don't have to enter them on the command line each time you run the program.

You can override every option set in the configuration file by using the command line option `-C` followed by the corresponding `section.key=value` pair.

    $ evql -C client.host=localhost

###File Format
EventQL uses the INI file format.

    [evql]
    host = prod.example.com ; execute queries on this server


###File path
By default EventQL tries to read the configuration from `/etc/{process}.conf` and `~/.evqlrc`.
You can specify a custom file path to read your configuration from with the command line option `-c file_path`.


###Configuration options
The EventQL configuration options arw grouped in three sections: `client`, `server` and `cluster`.

###client

**host** <br>
&nbsp;&nbsp;&nbsp;&nbsp;(Default: localhost) The IP address or hostname to send the query to.

**port**<br>
&nbsp;&nbsp;&nbsp;&nbsp;(Default: 9175) The port for the host.

**database**<br>
&nbsp;&nbsp;&nbsp;&nbsp;The database that should be used for following statements.

**user**

**password**

**auth_token**


###server
**name**

**datadir**

**listen**<commit_msg>docu: config file paths<commit_after>4.1 Configuration File
=====================

Configuration files aren't mandatory but they provide a convenient way to specifiy regularly used options, so you don't have to enter them on the command line each time you run the program.

###File Format
EventQL uses the INI file format, that is a simple text file grouped into sections that consists of key-value pairs.

    [evql]
    host = prod.example.com ; execute queries on this server

You can override every option set in the configuration file by using the command line option `-C` followed by the corresponding `section.key=value` pair.

    $ evql -C client.host=localhost



###File path

If not set explicitely with the --config option, EventQL will search for the configuration
file at the following locations:


#### /etc/evqld.conf
&nbsp;&nbsp;&nbsp;&nbsp; evqld configuration file

#### /etc/evql.conf
&nbsp;&nbsp;&nbsp;&nbsp; evql and evqlctl configuration file

#### ~/.evql.conf
&nbsp;&nbsp;&nbsp;&nbsp; evql and evqlctl configuration file, overwrites options from
/etc/evql.conf




###Configuration options
The EventQL configuration options arw grouped in three sections: `client`, `server` and `cluster`.

###client

**host** <br>
&nbsp;&nbsp;&nbsp;&nbsp;(Default: localhost) The IP address or hostname to send the query to.

**port**<br>
&nbsp;&nbsp;&nbsp;&nbsp;(Default: 9175) The port for the host.

**database**<br>
&nbsp;&nbsp;&nbsp;&nbsp;The database that should be used for following statements.

**user**

**password**

**auth_token**


###server
**name**

**datadir**

**listen**
{'fraction_non_alphanumeric': 0.12659098727210183, 'fraction_numerical': 0.0041279669762641896, 'mean_word_length': 4.922606924643585, 'pattern_counts': {'":': 0, '<': 9, '<?xml version=': 0, '>': 9, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2811815', 'n_tokens_mistral': 840, 'n_tokens_neox': 806, 'n_words': 357}