Skip to main content

Configuration

All services use standard ASP.NET Core configuration: appsettings.json, then environment variables with __ as the separator (Service__ApiKey sets Service:ApiKey).

Required secrets (deploy/.env)​

VariableUsed asRule
JWT_KEYAuth:JwtKey on the API32+ characters. Also derives the key that encrypts AI provider keys.
ADMIN_PASSWORDAuth:AdminPassword on the API; Taxonomy:Password on recommender and simulatorFirst admin; the service account GRE uses to read the catalogue
FIDO2_DOMAIN, FIDO2_ORIGINSFido2:ServerDomain, Fido2:Origins on the APIPasskeys. The web app's domain (no scheme or port) and its browser origin(s), comma separated. Default localhost and http://localhost:5173. Wrong values make passkey sign-in fail.
SERVICE_API_KEYService:ApiKey on every GRE service, Gre:ApiKey on the API16+ characters. Also derives the key that encrypts Kafka passwords.
POSTGRES_PASSWORDDatabase passwordDefault taxonomy; change it outside local use
ALLOW_PRIVATE_SOURCE_HOSTSNetwork:AllowPrivateHostsDevelopment only
VITE_API_URLWeb build argumentAddress the browser uses for the API

Per-service settings​

ServiceKeyDefault
allConnectionStrings:DefaultPostgres connection
allDb:AutoMigratetrue
allOTEL_EXPORTER_OTLP_ENDPOINT, OTEL_TRACES_SAMPLER_ARG, DEPLOYMENT_ENVIRONMENTunset (no export), 1 (0.01 for ingest), unset
APIDocuments:Directorydata/raw-html
APIAi:PromptPathbuilt-in Prompts/taxonomy-extraction.md
APIGre:ActivityUrl, ProfileUrl, RecommenderUrl, SimulatorUrl, IngestUrlhttp://localhost:8081 to 8085
ActivityActivity:Currency, Activity:MaxBatchEUR, 5000
ProfileActivity:Urlhttp://localhost:8081
RecommenderProfile:Url, Taxonomy:Url, Taxonomy:User, Taxonomy:Passwordlocalhost defaults, admin
RecommenderRecommender:AffinitySourceprofile
RecommenderRedis:Connectionunset (Redis source off)
RecommenderCrowd:Source, Crowd:SampleCustomers, Crowd:GamesPerCustomer, Crowd:ScanPage, Crowd:KeyPatternunset, 250000, 20, 500, c:*
RecommenderBuilds:CrowdEveryMinutes, Builds:CatalogueEveryMinutes, Builds:CheckSeconds0, 0, 30
RecommenderCache:ResultSeconds, Cache:MaxEntries60, 50000
Recommender, IngestStream:HalfLifeDays, Stream:KeyTtlDays14, 30
RecommenderStream:CountWeight, AmountWeight, TimeWeight, MinScore1, 1, 1, 0.05
IngestKafka:Bootstrap, TopicPrefix, GroupId, StartFrom, CreateTopics, Partitions, Formatlocalhost:9094, none, profile-state, earliest, true, 48, json
IngestRedis:Connection, Ingest:MaxBatch, Ingest:MaxWaitMs, Ingest:ConfigKeylocalhost:6380, 5000, 50, cfg:ingest
SimulatorActivity:Url, Profile:Url, Recommender:Url, Ingest:Url, Taxonomy:*, Kafka:Bootstrap, Kafka:Partitions, Kafka:TopicPrefixlocalhost defaults

Settings stored as data​

These are changed at runtime through the UI or API, not through configuration. Each has a revision.

SettingsWhereWho changes them
Similarity tuningpublic.similarity_settingseditor, Similarity Engine
Tagging promptpublic.agent_prompt_versioneditor, AI Tagging Agent
AI providerspublic.ai_provideradmin, AI providers
Affinity settingsprofile.settingseditor, Simulation Tune
Blend settingsrecommender.settingseditor, Simulation Tune
Kafka ingestionsRedis cfg:ingest:*admin, Kafka ingestion
Player-protection listrecommender.suppressed_customerresponsible-gambling system