Skip to main content

Configuration

This guide explains how to configure the Kreya application using various methods. Kreya resolves configuration settings from multiple sources in order of priority. Settings specified in higher-priority sources will overwrite those in lower-priority sources. To configure the proxy settings, check out the proxy documentation.

info

After adjusting the configuration, you must restart the Kreya application for the changes to take effect.

Configuration Sources

Kreya reads configuration settings from the following sources, in order of priority:

  1. Command Line Arguments
    Settings provided as command-line arguments take the highest priority.

  2. Environment Variables
    Environment variables prefixed with KREYA_ are used to configure Kreya. Environment variables used for configuration are case-insensitive.

  3. JSON Configuration Files
    Kreya supports JSON configuration files, which are loaded from platform-specific locations:

    • Windows:
      • %APPDATA%\Kreya\kreya.config.json
      • <working directory>\kreya.config.json
    • Linux:
      • $XDG_CONFIG_HOME/Kreya/kreya.config.json
      • ~/Kreya/kreya.config.json
      • <working directory>/kreya.config.json
    • macOS:
      • ~/Library/Application Support/Kreya/kreya.config.json
      • <working directory>/kreya.config.json

Available Configuration Options

The following options can be configured using JSON files or environment variables:

JSON KeyEnvironment VariableDescription
DisableAutoUpdatesKREYA_DisableAutoUpdatesDisables automatic updates.
Logging.LogLevel.DefaultKREYA_Logging_LogLevel_DefaultConfigures the default log level.
Available levels are None, Critical, Error, Warning, Information and Debug.
Logging.LogLevel.{Category}KREYA_Logging_LogLevel_{Category}Configures the log level of a logging category.
Available categories are KREYA and SYSTEM.
RestMaxResponseSizeKREYA_RestMaxResponseSizeSets the maximum response size for REST APIs.
ScriptingTimeoutKREYA_ScriptingTimeoutConfigures the timeout for scripts.
DisableTelemetryKREYA_DisableTelemetryDisables telemetry data collection.
MaxHistoryEntriesKREYA_MaxHistoryEntriesConfigures the maximum number of history entries.
MaxHistoryEntriesPerProjectKREYA_MaxHistoryEntriesPerProjectConfigures the maximum number of history entries per project.
MaxHistoryEntriesPerOperationKREYA_MaxHistoryEntriesPerOperationConfigures the maximum number of history entries per operation.

Example JSON Configuration File

Below is an example of a JSON configuration file:

{
"RestMaxResponseSize": 1048576,
"ScriptingTimeout": 30000,
"Logging": {
"LogLevel": {
"Default": "Warning",
"Kreya": "Information"
}
}
}