<a id="running-configuration"></a>

# Running configuration

This is the reloadable part of the configuration.
*halon-policyd* loads the reloadable configuration from `/etc/halon/policyd-app.yaml`.

It is described by, and can be validated with, the
[policyd-app.schema.json](http://lbovet.github.io/docson/index.html#https://docs.halon.io/json-schemas/policyd/1.1/policyd-app.schema.json).

<a id="authentication-directives"></a>

## Authentication directives

The authentication settings for the HTTP [HTTP API](api.html.md).

<a id="confval-authentication.apikeys"></a>

### authentication.apikeys[]

The API keys to allow.

<a id="ip-directives"></a>

## IP directives

<a id="confval-ips"></a>

### ips{}

The IP addresses.

<a id="confval-ips-.groupings"></a>

### ips{}.groupings[]

The groupings.

<a id="confval-ips-.groupings-.grouping"></a>

### ips{}.groupings[].grouping

The name of the grouping. **Required**

<a id="confval-ips-.groupings-.mode"></a>

### ips{}.groupings[].mode

The mode. Can be either `AUTO` or `MANUAL`. **Required**

<a id="confval-ips-.groupings-.paused"></a>

### ips{}.groupings[].paused

Indicates whether the grouping is paused for that IP address. The default is `false`.

<a id="confval-ips-.groupings-.start"></a>

### ips{}.groupings[].start

IP warmup start configuration for the grouping. **Required**

<a id="confval-ips-.groupings-.start.date"></a>

### ips{}.groupings[].start.date

The date when the IP warmup starts for the grouping. **Required**

<a id="confval-ips-.groupings-.start.volume"></a>

### ips{}.groupings[].start.volume

The starting volume for IP warmup for the grouping.

<a id="confval-ips-.groupings-.end"></a>

### ips{}.groupings[].end

IP warmup end configuration for the grouping.

<a id="confval-ips-.groupings-.end.date"></a>

### ips{}.groupings[].end.date

The date goal when the IP warmup should reach the target volume for the grouping.

<a id="confval-ips-.groupings-.end.volume"></a>

### ips{}.groupings[].end.volume

The target volume for IP warmup for the grouping.

<a id="confval-ips-.groupings-.algorithm"></a>

### ips{}.groupings[].algorithm

The rate-limiting algorithm for the grouping. Can be either `tokenbucket` or `fixedwindow`.

<a id="confval-ips-.groupings-.interval"></a>

### ips{}.groupings[].interval

The rate-limiting interval (in seconds). The default is 86400 seconds (1 day).

<a id="confval-ips-.groupings-.schedule"></a>

### ips{}.groupings[].schedule[]

The schedules.

<a id="confval-ips-.groupings-.schedule-.day"></a>

### ips{}.groupings[].schedule[].day

The day number. **Required**

<a id="confval-ips-.groupings-.schedule-.messages"></a>

### ips{}.groupings[].schedule[].messages

The amount of messages to attempt to send out. **Required**

<a id="confval-ips-.groupings-.properties"></a>

### ips{}.groupings[].properties{}

The custom properties to add to the policies that are created.
