Receiver configuration
The Receiver uses standard ASP.NET Core configuration, so every key below can be set in appsettings.json or as an environment variable with __ in place of : (Cratis:MongoDB:Server is Cratis__MongoDB__Server). The defaults are those in Source/Receiver/appsettings.json and the options classes. Running the Workbench shows them used in Source/Receiver/docker-compose.yml.
Chronicle
Section titled “Chronicle”| Key | Default | Purpose |
|---|---|---|
Cratis:Chronicle:ConnectionString |
chronicle://chronicle-dev-client:chronicle-dev-secret@localhost:35000 |
The Chronicle kernel the Workbench records its events in. The default holds the development credentials of the development image; use your own for a real deployment |
The Workbench uses an event store named Prologue, which is not configurable.
Workbench read models
Section titled “Workbench read models”| Key | Default | Purpose |
|---|---|---|
Cratis:MongoDB:Server |
mongodb://localhost:27017 |
The MongoDB server the Workbench reads its read models from |
Cratis:MongoDB:Database |
Prologue |
The database those read models live in |
Chronicle projects the Workbench’s read models into MongoDB, and the Receiver reads them from there. Both have to use the same MongoDB server and database. The development image of Chronicle bundles a replica set, which is why the compose file points both at the chronicle container with ?directConnection=true. For a durable deployment, run Chronicle against your own replica set and give the Receiver that server here.
Captures
Section titled “Captures”| Key | Default | Purpose |
|---|---|---|
Prologue:Mongo:ConnectionString |
mongodb://localhost:27017 |
The MongoDB server captures are stored in |
Prologue:Mongo:Database |
Prologue |
The database name |
Prologue:Mongo:Collection |
captures |
The collection name |
These are the keys the capture endpoints and the Interpreter’s service mode use; see Receiver API. Point Prologue:Mongo:ConnectionString at the same server as Cratis:MongoDB:Server.
Repositories
Section titled “Repositories”| Key | Default | Purpose |
|---|---|---|
Prologue:Repositories:CloneDirectory |
/var/prologue/repos |
Where repositories are cloned |
Prologue:Secrets:<name> |
none | The value of the secret a connection names |
The image installs the git command line, which cloning needs, and runs as the non-root app user, which owns /var/prologue/repos. Mount CloneDirectory on a volume if you want clones to survive a restart, and make the volume writable by that user (uid 1654).
A connection’s token is sent only to the host of that connection and only over https; see Security and exposure.
Recording
Section titled “Recording”| Key | Default | Purpose |
|---|---|---|
Prologue:Recording:ItemTimeout |
00:00:10 |
How long a background worker waits for Chronicle to record one item before it gives up on it and moves to the next |
The Receiver stores a capture or parity observation first and records it for the Workbench from a background queue. If Chronicle is unreachable, an item that does not finish within ItemTimeout is logged as an error and dropped from the queue, so the items behind it still get recorded once Chronicle is back. The capture itself stays stored and the Interpreter still reads it, but the Workbench does not show it until it is captured again. The same limit applies to Discover recording an analysis and to Events recording an interpretation; those two show the run as failed with the reason, and you can run them again.
Discover
Section titled “Discover”| Key | Default | Purpose |
|---|---|---|
Prologue:Discover:AllowedRoots |
none | The folders Analyze folder and local-folder systems may read. When set, a folder has to be one of them or inside one (. and .. segments and links are resolved first); when not set, any folder the Receiver can read is allowed |
Set it as a list, for example Prologue__Discover__AllowedRoots__0=/srv/code in the environment.
How secrets are resolved
Section titled “How secrets are resolved”A repository connection stores only the name of a secret, such as github/prologue-read. When a clone needs the token, the Receiver looks the name up in this order and uses the first non-empty value:
- The configuration key
Prologue:Secrets:<name>, for examplePrologue:Secrets:github/prologue-read. - An environment variable named
PROLOGUE_SECRET_followed by the secret’s name, where every character that is not an ASCII letter or digit becomes an underscore and the result is upper case.github/prologue-readisPROLOGUE_SECRET_GITHUB_PROLOGUE_READ.
A secret never resolves from an arbitrary environment variable. The fixed prefix means a name typed into the Workbench cannot read a connection string or API key that was meant for the Receiver itself. A secret name is 1 to 64 letters, digits, _, ., / or -; anything else, and anything that looks like a token, is refused when you enter it.
If neither is set the clone fails with the message The secret '<name>' is not configured on the Receiver. The token is passed to git through its process environment and is removed from any failure message. It is never stored, logged or returned to the browser.
Environment variable names cannot contain / or -, which is why a secret named github/prologue-read is easiest to supply as PROLOGUE_SECRET_GITHUB_PROLOGUE_READ.
The same lookup expands ${secret:<name>} placeholders in cratis-prologue.json for the Extractor and the Interpreter. See Secret placeholders.
Other settings
Section titled “Other settings”The Receiver listens on port 8080 in the image (ASPNETCORE_URLS=http://0.0.0.0:8080). AI providers, pools and agents are not configured here; they are set up in the Workbench. See AI setup.