Configuration keys table (OwnSona Manual)

Next: Database schema reference, Up: Reference [Contents][Index]

14.1 Configuration keys table ¶

Every key recognized in src/main/backend/application.ini.

Required
Optional with defaults
Connection pool tunables (Kiss-provided)

14.1.1 Required ¶

Key	Purpose
`DatabaseHost`	Postgres host.
`DatabasePort`	Postgres port.
`DatabaseName`	Database name (typically `ownsona`).
`DatabaseUser`	Application role.
`DatabasePassword`	Password for the application role.
`OWNSONA_LOGIN_USERNAME`	Username the OAuth AS consent page accepts.
`OWNSONA_LOGIN_PASSWORD`	Password the OAuth AS consent page accepts.
`OAuthAuthorizationServer`	Canonical public URL of the OwnSona server (also the AS issuer and resource identifier).
`OAuthAsEnabled`	`true` to enable the embedded authorization server.
`EMBEDDING_API_KEY`	API key for the embeddings endpoint.
`EMBEDDING_ENDPOINT`	Full URL of the `/embeddings` endpoint.
`EMBEDDING_MODEL`	Embedding model identifier.
`EMBEDDING_DIMENSIONS`	Vector length. Must match `vector(N)` column.

14.1.2 Optional with defaults ¶

Key	Default	Purpose
`DatabaseType`	`PostgreSQL`	Kiss DB driver type (only PostgreSQL supported).
`DatabaseConnectionParameters`	(none)	Appended to JDBC URL.
`OWNSONA_USER_ID`	`default`	User-id stamped on every memory.
`EMBEDDING_PROVIDER`	`openai`	Provider name recorded per row.
`DEFAULT_RECALL_LIMIT`	`8`	Default `limit` for `recall`.
`MAX_RECALL_LIMIT`	`50`	Hard cap on `limit`.
`MAX_TEXT_CHARS`	`16000`	Hard cap on memory text length.
`MAX_BATCH_SIZE`	`200`	Max items per `remember_batch`.
`REEMBED_ON_STARTUP`	`false`	Triggers the re-embed walker. Auto-flipped after success.
`LLM_API_KEY`	(none)	Generative-LLM key. Unset = generative background features disabled.
`LLM_MODEL`	(none)	Chat model id (required iff `LLM_API_KEY` set).
`LLM_ENDPOINT`	(none)	OpenAI-compatible chat URL (required iff `LLM_API_KEY` set).
`LLM_PROVIDER`	`openai`	Generative provider label (logging only).
`CONSOLIDATION_ENABLED`	`false`	Enable the merge/dedup background pass.
`CONSOLIDATION_THRESHOLD`	`0.95`	Cosine cutoff for the merge pass.
`CONFLICT_RESOLUTION_ENABLED`	`false`	Enable the auto conflict-resolution pass.
`CONFLICT_RESOLUTION_THRESHOLD`	`0.80`	Tag-gated cosine cutoff for the conflict pass.
`CONSOLIDATION_MAX_GROUPS`	`25`	Per-pass cap on clusters (LLM-cost bound).
`GRAPH_EXTRACTION_ENABLED`	`false`	Enable relation-triple extraction.
`GRAPH_EXTRACTION_MAX_MEMORIES`	`25`	Memories extracted per run (LLM-cost bound).
`GRAPH_MAX_HOPS`	`2`	Default/cap hops for `query_relations` (hard cap 5).
`GRAPH_MAX_RELATIONS`	`200`	Cap on relations returned per `query_relations`.
`OAuthAsIniFile`	`oauth.ini`	Path to the AS persistence file. Strongly recommended: absolute path outside the deployed webapp.
`OAuthRequiredScopes`	(none)	Comma- or space-separated list of scopes every access token must carry.
`OAuthResourceIdentifier`	= `OAuthAuthorizationServer`	Override for the `aud` value tokens must carry.
`OAuthAsIssuer`	= `OAuthAuthorizationServer`	Override for the AS issuer URL.
`OAuthJwksUri`	auto-discovered	Override for the JWKS URL. Default is discovered via RFC 8414.
`OAuthAccessTokenTtlSeconds`	`3600`	Access token TTL.
`OAuthRefreshTokenTtlSeconds`	`2592000`	Refresh token TTL (30 days).
`OAuthAllowDynamicRegistration`	`true`	Enables `/oauth/register`. Disabling breaks every modern MCP client.
`MaxWorkerThreads`	`30`	Kiss tunable: concurrent request cap.
`UserInactiveSeconds`	`900`	Kiss tunable: session inactivity timeout (unused by OAuth path).

14.1.3 Connection pool tunables (Kiss-provided) ¶

Rarely changed. Defaults come from c3p0; override when your workload calls for it.

Key	Purpose
`DatabaseMinPoolSize`	Minimum connections kept hot.
`DatabaseInitialPoolSize`	Pool size at startup.
`DatabaseMaxPoolSize`	Hard cap on pool size.
`DatabaseAcquireIncrement`	Connections added per growth step.
`DatabaseCheckoutTimeout`	Millis to wait before timing out.
`DatabaseMaxStatements`	Prepared-statement cache size.
`DatabaseIdleTestPeriod`	Seconds between idle-connection tests.
`DatabaseMaxIdleTime`	Seconds before removing idle connections.