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

# Startup configuration

*halon-dlpd* loads the non-reloadable startup configuration is read from `/etc/halon/dlpd.yaml`.

Below are some of the most important settings that can be configured.

> **Note**
> 
> The example configuration in  */opt/halon/share/examples/* that is usually copied
> to  */etc/halon/* during installation contains reasonable defaults.
> Normally you only need to modify the secret key to use.

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

## Environment directives

The default startup configuration that came with the installation package
contains reasonable defaults for your platform. Some settings should however
be revised.

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

### Configuration paths

Those paths can normally be left unchanged.

<a id="confval-environment.appconf"></a>

#### environment.appconf

From where to load the [running configuration](config_dlpd_app.html.md).
The default is  */etc/halon/dlpd-app.yaml*.

<a id="other-environment"></a>

### Other environment

Those settings should normally be left unchanged.
The default startup configuration in  */opt/halon/examples*
that came with the installation package should contain
correct parameters for your operating system or distribution.

<a id="confval-environment.socket.path"></a>

#### environment.socket.path

Have the API socket on a UNIX socket. This option is mutually exclusive with the [`environment.controlsocket.port`](#confval-environment.controlsocket.port) setting. The default is `/var/run/halon/dlpd.sock`.

<a id="confval-environment.socket.owner"></a>

#### environment.socket.owner

This option is only supported with the [`environment.socket.path`](#confval-environment.socket.path) setting.

<a id="confval-environment.socket.group"></a>

#### environment.socket.group

This option is only supported with the [`environment.socket.path`](#confval-environment.socket.path) setting.

<a id="confval-environment.socket.chmod"></a>

#### environment.socket.chmod

This option is only supported with the [`environment.socket.path`](#confval-environment.socket.path) setting.

<a id="confval-environment.controlsocket.path"></a>

#### environment.controlsocket.path

Have the control socket on a UNIX socket. This option is mutually exclusive with the [`environment.controlsocket.port`](#confval-environment.controlsocket.port) setting. The default is `/var/run/halon/dlpd.ctl`.

<a id="confval-environment.controlsocket.owner"></a>

#### environment.controlsocket.owner

This option is only supported with the [`environment.controlsocket.path`](#confval-environment.controlsocket.path) setting.

<a id="confval-environment.controlsocket.group"></a>

#### environment.controlsocket.group

This option is only supported with the [`environment.controlsocket.path`](#confval-environment.controlsocket.path) setting.

<a id="confval-environment.controlsocket.chmod"></a>

#### environment.controlsocket.chmod

This option is only supported with the [`environment.controlsocket.path`](#confval-environment.controlsocket.path) setting.

<a id="confval-environment.controlsocket.port"></a>

#### environment.controlsocket.port

Have the control socket on a TCP port. This option is mutually exclusive with the [`environment.controlsocket.path`](#confval-environment.controlsocket.path) setting.

<a id="confval-environment.controlsocket.address"></a>

#### environment.controlsocket.address

Have the control socket listen on a specific IP address. This option is only supported with the [`environment.controlsocket.port`](#confval-environment.controlsocket.port) setting.

<a id="confval-environment.privdrop.user"></a>

#### environment.privdrop.user

The user to run the process as.

<a id="confval-environment.privdrop.group"></a>

#### environment.privdrop.group

The group to run the process as.

<a id="confval-environment.umask"></a>

#### environment.umask

Application umask after privdrop

<a id="confval-environment.tmpdir"></a>

#### environment.tmpdir

The default temp path for storing extracted files. The default is `/var/spool/halon/tmp/dlpd`.
