---
title: "Rest PKI Core Settings"
description: "Reference of Rest PKI Core settings for on-premises instances: where the settings are defined on each platform, how they are named and where the settings of each feature are documented."
canonical: "https://docs.lacunasoftware.com/en-us/articles/rest-pki/core/on-premises/settings"
locale: "en"
product: "Rest PKI Core"
last_updated: "2026-10-20"
---

# Rest PKI Core Settings

Rest PKI Core reads its settings from a configuration file or from environment variables, depending on the platform
of the installation. Restart the application after changing any setting: most settings only take effect at startup.

## Where the settings are defined

| Platform | Where to define the settings |
|---|---|
| [Linux](https://docs.lacunasoftware.com/en-us/articles/rest-pki/core/on-premises/linux) | File `/etc/restpkicore/appsettings.conf` |
| [Windows Server](https://docs.lacunasoftware.com/en-us/articles/rest-pki/core/on-premises/windows-server) | File `C:\ProgramData\Lacuna Software\Rest PKI Core\appsettings.ini` |
| [Docker](https://docs.lacunasoftware.com/en-us/articles/rest-pki/core/on-premises/docker) | Environment variables of the container |
| [Azure App Services](https://docs.lacunasoftware.com/en-us/articles/rest-pki/core/on-premises/azure) | *Application settings* of the App Service |

Environment variables work on every platform and take precedence over the configuration file: when a setting is
defined in both, the value of the environment variable is used.

## How settings are named

Each setting has a section and a key, and is written differently in a configuration file and in an environment
variable. For example, the keys `Type` and `Path` of section `BlobStorage`:

In the configuration file:

```ini
[BlobStorage]
Type=FileSystem
Path=/var/files/myapp
```

As an environment variable (Docker and Azure App Services), with `__` between the section and the key:

```
BlobStorage__Type=FileSystem
BlobStorage__Path=/var/files/myapp
```

## Settings by feature

* [Biometrics](https://docs.lacunasoftware.com/en-us/articles/rest-pki/core/on-premises/settings/biometrics): enrollment batches and the job that looks after them
* [Blob storage](https://docs.lacunasoftware.com/en-us/articles/rest-pki/core/on-premises/configure-blob-storage): where the application stores files
* [Email sending](https://docs.lacunasoftware.com/en-us/articles/rest-pki/core/on-premises/configure-email): SMTP server used to send emails
* [OpenID Connect](https://docs.lacunasoftware.com/en-us/articles/rest-pki/core/on-premises/configure-oidc): integration with GrantID for user management
* [Timestamping](https://docs.lacunasoftware.com/en-us/articles/rest-pki/core/on-premises/configure-timestamp): timestamp servers used by the application
* [Logging](https://docs.lacunasoftware.com/en-us/articles/rest-pki/core/on-premises/logging): destinations and levels of the logs