Gessa Docs
Generated Reference

Reference

Configuration Flags

Sources: server/src/config/config.ts:AppConfigSchema.
engine v1.0.234Copy for LLM

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

FlagTypeOptionalDefaultDescription
aiDevBudgetExemptbooleannofalseno description
aiRunWorkerCountnumberyesno defaultno description
assetBucketNamestringyesno defaultno description
awsAccountIdstringyesno defaultno description
awsProfilestringyesno defaultno description
awsRegionstringyesno defaultno description
awsStackNamestringyesno defaultno description
cloudfrontDistributionIdstringyesno defaultno description
databaseMigrationsManagedExternallybooleannofalseno description
databaseMigrationTargetstringyesno defaultno description
databaseUrlstringyesno defaultno description
desktopAttestationcustomnono defaultno description
devAuthEnabledbooleannotrueno description
emailSuppressionEvidenceKeyringJsonstringyesno defaultno description
engineEnvenum(local | dev | staging | production)no"local"no description
healthMonitorEnabledbooleanyesno defaultno description
hoststringno"0.0.0.0"no description
maintenanceModebooleannofalseno description
migrationDatabaseUrlstringyesno defaultno description
nodeEnvstringno"development"no description
openAiPlatformApiKeystringyesno defaultno description
openAiPlatformApiKeySecretArnstringyesno defaultno description
openRouterApiKeystringyesno defaultno description
openRouterApiKeySecretArnstringyesno defaultno description
platformAuthPreviousSecretsarray<string>no[]no description
platformAuthSecretstringyesno defaultno description
platformBootstrapTokenstringyesno defaultno description
portnumberno8787no description
publicBaseUrlstringyesno defaultno description
redisUrlstringyesno defaultno description
runtimeLeaseReaperEnabledbooleanyesno defaultno description
runtimeLeaseReaperIntervalMsnumberyesno defaultno description
runtimeTeleportHandoffTokenKeyringobjectyesno defaultno description
secretEncryptionKeystringyesno defaultno description
secretsParameterPrefixstringyesno defaultno description
smsFactorEnabledbooleannofalseno description
versioningCheckpointObjectBucketstringyesno defaultno description
websocketBaseUrlstringyesno defaultno 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
Was this helpful?Report an issueContact support

On this page