# Configuration options

This page lists every supported configuration key for the Kameleo Engine service. For procedural guidance (where to place appsettings.json, how to set environment variables or flags, and precedence rules) see Configure.

All keys are optional unless stated. Defaults apply when omitted. Precedence (highest to lowest): flags > environment variables > file.

# Configuration keys

JSON key	Environment variable	Command line flag	Default	Description
`ListeningHost`	`LISTENINGHOST`	`listeningHost`	`+`	Host interface to bind. `+` accepts connections from any network interface.
`ListeningPort`	`LISTENINGPORT`	`listeningPort`	`5050`	TCP port exposed for the local API.
`Pat`	`PAT`	`pat`	(none)	Personal access token for authentication. Generate one at https://login.kameleo.io/PAT.
`Verbose`	`VERBOSE`	`verbose`	`1`	Log verbosity: `0` = minimal, `1` = normal, `2` = detailed diagnostics.
`UserDirectoryOverride`	`USERDIRECTORYOVERRIDE`	`userDirectoryOverride`	(platform default)	Overrides default user directory (`%APPDATA%\Kameleo` or `~/Library/Application Support/Kameleo`).
`WorkspaceFolder`	`WORKSPACEFOLDER`	`workspaceFolder`	`Workspace`	Workspace root folder. Relative paths resolve under the user directory.

# Notes

Omitted authentication key (Pat) starts the service accountless; some features will be unavailable.
Use higher verbosity (Verbose=2) only for troubleshooting; it increases log volume.
Paths can be absolute or relative. Relative paths resolve against the effective user directory (override if set).