---
title: "Configuration Flags"
description: "Sources: `server/src/config/config.ts:AppConfigSchema`."
engineVersion: v1.0.234
date: 2026-09-28
license: "(c) Gessa, proprietary. Cite with attribution to https://gessa.ai/docs/. Terms: https://gessa.ai/terms/."
canonical: https://gessa.ai/docs/spec/generated/config-flags/
---
<!-- GENERATED FILE: do not edit by hand. -->
<!-- Regenerate with `npm run gen-docs`. -->

Sources: `server/src/config/config.ts:AppConfigSchema`.

# Configuration Flags

This generated snapshot is derived from the `AppConfigSchema` Zod object in `server/src/config/config.ts`. It is the typed source of truth for the server runtime configuration. Field names are the parsed configuration keys; the environment-variable bindings that populate them are resolved imperatively in `loadConfig` and are not part of this typed projection. A flag with no schema-level description is emitted as `no description`.

Flag count: `38`.
Flags without a description: `38`.

## Flags

| Flag | Type | Optional | Default | Description |
| --- | --- | --- | --- | --- |
| `aiDevBudgetExempt` | `boolean` | no | `false` | no description |
| `aiRunWorkerCount` | `number` | yes | no default | no description |
| `assetBucketName` | `string` | yes | no default | no description |
| `awsAccountId` | `string` | yes | no default | no description |
| `awsProfile` | `string` | yes | no default | no description |
| `awsRegion` | `string` | yes | no default | no description |
| `awsStackName` | `string` | yes | no default | no description |
| `cloudfrontDistributionId` | `string` | yes | no default | no description |
| `databaseMigrationsManagedExternally` | `boolean` | no | `false` | no description |
| `databaseMigrationTarget` | `string` | yes | no default | no description |
| `databaseUrl` | `string` | yes | no default | no description |
| `desktopAttestation` | `custom` | no | no default | no description |
| `devAuthEnabled` | `boolean` | no | `true` | no description |
| `emailSuppressionEvidenceKeyringJson` | `string` | yes | no default | no description |
| `engineEnv` | `enum(local \| dev \| staging \| production)` | no | `"local"` | no description |
| `healthMonitorEnabled` | `boolean` | yes | no default | no description |
| `host` | `string` | no | `"0.0.0.0"` | no description |
| `maintenanceMode` | `boolean` | no | `false` | no description |
| `migrationDatabaseUrl` | `string` | yes | no default | no description |
| `nodeEnv` | `string` | no | `"development"` | no description |
| `openAiPlatformApiKey` | `string` | yes | no default | no description |
| `openAiPlatformApiKeySecretArn` | `string` | yes | no default | no description |
| `openRouterApiKey` | `string` | yes | no default | no description |
| `openRouterApiKeySecretArn` | `string` | yes | no default | no description |
| `platformAuthPreviousSecrets` | `array<string>` | no | `[]` | no description |
| `platformAuthSecret` | `string` | yes | no default | no description |
| `platformBootstrapToken` | `string` | yes | no default | no description |
| `port` | `number` | no | `8787` | no description |
| `publicBaseUrl` | `string` | yes | no default | no description |
| `redisUrl` | `string` | yes | no default | no description |
| `runtimeLeaseReaperEnabled` | `boolean` | yes | no default | no description |
| `runtimeLeaseReaperIntervalMs` | `number` | yes | no default | no description |
| `runtimeTeleportHandoffTokenKeyring` | `object` | yes | no default | no description |
| `secretEncryptionKey` | `string` | yes | no default | no description |
| `secretsParameterPrefix` | `string` | yes | no default | no description |
| `smsFactorEnabled` | `boolean` | no | `false` | no description |
| `versioningCheckpointObjectBucket` | `string` | yes | no default | no description |
| `websocketBaseUrl` | `string` | yes | no default | no description |

## Flag reference

### aiDevBudgetExempt

- Type: `boolean`
- Optional: no
- Default: `false`
- Description: no description

### aiRunWorkerCount

- Type: `number`
- Optional: yes
- Default: no default
- Description: no description

### assetBucketName

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### awsAccountId

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### awsProfile

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### awsRegion

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### awsStackName

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### cloudfrontDistributionId

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### databaseMigrationsManagedExternally

- Type: `boolean`
- Optional: no
- Default: `false`
- Description: no description

### databaseMigrationTarget

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### databaseUrl

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### desktopAttestation

- Type: `custom`
- Optional: no
- Default: no default
- Description: no description

### devAuthEnabled

- Type: `boolean`
- Optional: no
- Default: `true`
- Description: no description

### emailSuppressionEvidenceKeyringJson

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### engineEnv

- Type: `enum(local | dev | staging | production)`
- Optional: no
- Default: `"local"`
- Description: no description

### healthMonitorEnabled

- Type: `boolean`
- Optional: yes
- Default: no default
- Description: no description

### host

- Type: `string`
- Optional: no
- Default: `"0.0.0.0"`
- Description: no description

### maintenanceMode

- Type: `boolean`
- Optional: no
- Default: `false`
- Description: no description

### migrationDatabaseUrl

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### nodeEnv

- Type: `string`
- Optional: no
- Default: `"development"`
- Description: no description

### openAiPlatformApiKey

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### openAiPlatformApiKeySecretArn

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### openRouterApiKey

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### openRouterApiKeySecretArn

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### platformAuthPreviousSecrets

- Type: `array<string>`
- Optional: no
- Default: `[]`
- Description: no description

### platformAuthSecret

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### platformBootstrapToken

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### port

- Type: `number`
- Optional: no
- Default: `8787`
- Description: no description

### publicBaseUrl

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### redisUrl

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### runtimeLeaseReaperEnabled

- Type: `boolean`
- Optional: yes
- Default: no default
- Description: no description

### runtimeLeaseReaperIntervalMs

- Type: `number`
- Optional: yes
- Default: no default
- Description: no description

### runtimeTeleportHandoffTokenKeyring

- Type: `object`
- Optional: yes
- Default: no default
- Description: no description

### secretEncryptionKey

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### secretsParameterPrefix

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### smsFactorEnabled

- Type: `boolean`
- Optional: no
- Default: `false`
- Description: no description

### versioningCheckpointObjectBucket

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description

### websocketBaseUrl

- Type: `string`
- Optional: yes
- Default: no default
- Description: no description