Every key recognized in src/main/backend/application.ini.
| 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. |
| 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. |
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). |
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. |