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)
| Variable | Used as | Rule |
|---|---|---|
JWT_KEY | Auth:JwtKey on the API | 32+ characters. Also derives the key that encrypts AI provider keys. |
ADMIN_PASSWORD | Auth:AdminPassword on the API; Taxonomy:Password on recommender and simulator | First admin; the service account GRE uses to read the catalogue |
FIDO2_DOMAIN, FIDO2_ORIGINS | Fido2:ServerDomain, Fido2:Origins on the API | Passkeys. 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_KEY | Service:ApiKey on every GRE service, Gre:ApiKey on the API | 16+ characters. Also derives the key that encrypts Kafka passwords. |
POSTGRES_PASSWORD | Database password | Default taxonomy; change it outside local use |
ALLOW_PRIVATE_SOURCE_HOSTS | Network:AllowPrivateHosts | Development only |
VITE_API_URL | Web build argument | Address the browser uses for the API |
Per-service settings
| Service | Key | Default |
|---|---|---|
| all | ConnectionStrings:Default | Postgres connection |
| all | Db:AutoMigrate | true |
| all | OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_TRACES_SAMPLER_ARG, DEPLOYMENT_ENVIRONMENT | unset (no export), 1 (0.01 for ingest), unset |
| API | Documents:Directory | data/raw-html |
| API | Ai:PromptPath | built-in Prompts/taxonomy-extraction.md |
| API | Gre:ActivityUrl, ProfileUrl, RecommenderUrl, SimulatorUrl, IngestUrl | http://localhost:8081 to 8085 |
| Activity | Activity:Currency, Activity:MaxBatch | EUR, 5000 |
| Profile | Activity:Url | http://localhost:8081 |
| Recommender | Profile:Url, Taxonomy:Url, Taxonomy:User, Taxonomy:Password | localhost defaults, admin |
| Recommender | Recommender:AffinitySource | profile |
| Recommender | Redis:Connection | unset (Redis source off) |
| Recommender | Crowd:Source, Crowd:SampleCustomers, Crowd:GamesPerCustomer, Crowd:ScanPage, Crowd:KeyPattern | unset, 250000, 20, 500, c:* |
| Recommender | Builds:CrowdEveryMinutes, Builds:CatalogueEveryMinutes, Builds:CheckSeconds | 0, 0, 30 |
| Recommender | Cache:ResultSeconds, Cache:MaxEntries | 60, 50000 |
| Recommender, Ingest | Stream:HalfLifeDays, Stream:KeyTtlDays | 14, 30 |
| Recommender | Stream:CountWeight, AmountWeight, TimeWeight, MinScore | 1, 1, 1, 0.05 |
| Ingest | Kafka:Bootstrap, TopicPrefix, GroupId, StartFrom, CreateTopics, Partitions, Format | localhost:9094, none, profile-state, earliest, true, 48, json |
| Ingest | Redis:Connection, Ingest:MaxBatch, Ingest:MaxWaitMs, Ingest:ConfigKey | localhost:6380, 5000, 50, cfg:ingest |
| Simulator | Activity:Url, Profile:Url, Recommender:Url, Ingest:Url, Taxonomy:*, Kafka:Bootstrap, Kafka:Partitions, Kafka:TopicPrefix | localhost defaults |
Settings stored as data
These are changed at runtime through the UI or API, not through configuration. Each has a revision.
| Settings | Where | Who changes them |
|---|---|---|
| Similarity tuning | public.similarity_settings | editor, Similarity Engine |
| Tagging prompt | public.agent_prompt_version | editor, AI Tagging Agent |
| AI providers | public.ai_provider | admin, AI providers |
| Affinity settings | profile.settings | editor, Simulation Tune |
| Blend settings | recommender.settings | editor, Simulation Tune |
| Kafka ingestions | Redis cfg:ingest:* | admin, Kafka ingestion |
| Player-protection list | recommender.suppressed_customer | responsible-gambling system |