FastAPI settings
Every setting of the FastAPI host, with its default, its bounds and what it does. The FastAPI page shows how to include the routers; the wire page describes the requests and answers they serve.
Where settings come from
Datum reads the settings from three sources. The first source that names a setting wins.
- Keyword arguments to
Datum.Settings(...) - Environment variables.
- A TOML file named by
DATUM_. The variable must name an existing file, or the start stops.CONFIG_ FILE
A name in the environment is DATUM_ plus the setting's path in capitals, with __ between levels: datum. is DATUM_. Names are matched without regard to case, and an empty value counts as unset. A list or a mapping is written as JSON text (DATUM_), or a mapping one key at a time (DATUM_). A key written in the environment comes out in lower case, so a binding id or a form key with capitals belongs in the TOML file. Values from the sources are merged level by level, so the environment can change one setting the TOML file also sets.
In the TOML file the tables are the setting paths without the leading datum:
[web.api.endpoints]
submissions = true
validate = true
[runtime.validation]
time_limit = 3
memory = "64MiB"
[web.throttle]
limit = 30
[forms]
locations = ["forms/*.json"]The same settings in the environment:
export DATUM_WEB__API__ENDPOINTS__SUBMISSIONS=true
export DATUM_WEB__API__ENDPOINTS__VALIDATE=true
export DATUM_RUNTIME__VALIDATION__TIME_LIMIT=3
export DATUM_RUNTIME__VALIDATION__MEMORY=64MiB
export DATUM_WEB__THROTTLE__LIMIT=30
export DATUM_FORMS__LOCATIONS='["forms/*.json"]'python -m datum_ writes the JSON Schema of every setting to a file, or into a directory as datum-settings.. The same schema ships inside datum-core.
A value that cannot work stops the start and names the setting: a number outside its bounds, a word that is not one of the allowed ones (the message lists them and offers the closest), a missing file, a password that is too short. A DATUM_ variable that matches no setting is warned about (datum.); with datum. it stops the start instead. The next section lists the value forms and the rules that tie settings together.
Value forms and rules across settings
| Form | What it accepts |
|---|---|
| Seconds | A number (5, 0.), a numeric string, or an ISO 8601 duration (PT5). A boolean is refused. |
| Size | A whole number of bytes, or a size such as 32 (binary) or 32 (decimal). A boolean is refused. |
| Word | One of a closed set, matched without regard to case. |
| Secret | Never shown in a log, an error or a dump. A secret that sets a minimum length refuses a shorter value and reports the length only. |
| Credential address | A URI that may hold credentials. Its user-info is hidden in logs and in the JSON dump. |
Rules that tie several settings together, each of which stops the start:
datum.needsruntime. qjs_ sha256 datum..runtime. qjs_ path - A signing key (
datum.andpdf. signing datum.) of typetsa. signer PKCS12needspkcs12_and refusesfile key_,password key_andfile cert_. A key of typefile PEMneedskey_andfile cert_and refusesfile pkcs12_,file pkcs12_andpassword friendly_. An empty password counts as unset. The files are read once at start, at most 1 MiB each, so a renewed key takes a restart. The first certificate must be the certificate of the private key, the key must be RSA (2048 bits or more) or ECDSA P-256 or P-384, and aname friendly_must equal the friendly name of the key's certificate in the store; it checks, it does not choose.name datum.refuses a named key file as well.tsa. signer. self_ signed datum.needstsa. enabled datum., and every policy is checked as an OID.tsa. policy datum.withtsa. client_ store = sql access = clientsneeds a client store passed toDatum(tsa_.client_ store=...) - The timestamp client of a PDF signature needs an
httporhttpsaddress with a host.basic_anduser basic_are set together or not at all, andpassword basic_holds no colon. A bearer token, Basic credentials or user-info in the address are refused for anuser httpaddress that is not loopback. - A throttle storage that is not memory needs
datum.(web. throttle. key_ salt datum.).E005 - Each entry of
datum.is at least 1.web. throttle. limits - Every binding named in
datum.must be in the catalogue, and every PDF theme a used binding suggests (other thanbindings datum-pdf) must be supplied underdatum..bindings. pdf_ themes datum.names only known check ids, and never an ERROR check.silenced_ checks - A PDF or timestamp capability that is on needs its extra installed (
datum-core[pdf],datum-core[timestamp]).
datum
The top of the tree.
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | true | Boolean. When false, every Datum router adds no routes. |
datum. | DATUM_ | false | Boolean. When true, a DATUM_ variable that names no setting stops the start instead of warning (datum.). |
datum. | DATUM_ | none | List of check ids to leave out of the log, such as ["datum.. Only INFO and WARNING checks can be silenced; an unknown id or an ERROR id is refused. |
datum. | DATUM_ | unset | Whole number, at least 1. The number of worker processes the deployment runs. Unset, the host reads WEB_ as a hint, else 1. The memory check (datum.) and the builder's shared-store rule (datum.) read it. |
datum.runtime
The program runtime: the sandbox that runs the form program and the PDF program.
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | wasmtime | Text. The id of the engine provider. An unknown or unavailable id stops the start. |
datum. | DATUM_ | true | Boolean. When true, a runtime that cannot be brought up stops the start. |
datum. | DATUM_ | 3 | Whole number, 0 or more. Runs made at start to warm the engine. The host always makes at least one, so 0 behaves as 1. |
datum. | DATUM_ | 10 s | Seconds, 0 or more. How long shutdown waits for runs in flight. Keep it below the process manager's own timeout. |
datum. | DATUM_ | 30 s | Seconds, at least 0.001. The time allowed for the runtime to start. A start that runs past it fails with datum.. |
datum. | DATUM_ | 0. s | Seconds, at least 0.001. The resolution of the clock the runs share. |
datum. | DATUM_ | unset | Text. A directory local to the container for the runtime's working files. Unset uses the system temporary directory. |
datum. | DATUM_ | 5 s | Seconds, 0 or more. How long the engine waits when it stops a run. |
datum. | DATUM_ | 0 | Whole number, 0 or more. Stray runs tolerated. 0 means one per CPU, at least 2. |
datum. | DATUM_ | 0 | Whole number, 0 or more. The worker threads the limiter allows for runs plus hooks in flight. 0 means 2 times the slots plus 2, where the slots are the validation and PDF slots together. To size it yourself use slots plus the slots times hook time on a thread over run time, rounded up, plus 2; blocking work on the worker thread (a synchronous store, the timestamp client) counts as hook time. A call that gets no thread within datum. answers 503 server.. |
datum. | DATUM_ | unset | Text. The path of your own copy of qjs-wasi.. Unset uses the packaged, pinned module. |
datum. | DATUM_ | unset | Text, 64 hexadecimal characters. The SHA-256 of your own copy. It needs qjs_. |
datum. | DATUM_ | 20 | Size. The largest PDF the verify route reads; a larger one answers 413. A value outside 1 MiB to 100 MiB is moved to the nearest bound with datum.. |
datum.runtime.validation
The budgets of one validation run. Each value outside its bounds is moved to the nearest bound with datum..
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | 5 s | Seconds, more than 0. The time limit of a run. Bounds 0.001 s to 60 s. |
datum. | DATUM_ | 32 | Size. The memory of a run. Bounds 4 MiB to 1 GiB. A value below what the runtime module needs to start is an error (datum.), never clamped up. |
datum. | DATUM_ | 0 | Whole number, 0 or more. Concurrent runs. 0 means one per CPU. At most 64. |
datum. | DATUM_ | 2 s | Seconds, 0 or more. How long a run waits for a slot before the answer is 503. At most 10 s. |
datum.runtime.pdf
The budgets of one PDF run, on the same rules.
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | 60 s | Seconds, more than 0. The time limit of a run. Bounds 0.001 s to 300 s. |
datum. | DATUM_ | 256 | Size. The memory of a run. Bounds 32 MiB to 4 GiB. A value below what the runtime module needs to start is an error (datum.). |
datum. | DATUM_ | 0 | Whole number, 0 or more. Concurrent runs. 0 means the smaller of 2 and the CPUs. At most 64. |
datum. | DATUM_ | 2 s | Seconds, 0 or more. How long a run waits for a slot before the answer is 503. At most 10 s. |
datum.runtime.programs
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | unset | Text. The path of the form program. Unset uses the packaged program, which is still checked against its digest. A path that cannot be read stops the start. |
datum. | DATUM_ | unset | Text. The path of the PDF program, on the same terms. |
datum.host
Options the form program reads on every run.
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | fail | Word: fail or warn. What a formula that cannot be evaluated does. |
datum. | DATUM_ | refuse | Word: refuse or allow. What a regular expression that repeats a repeat does. |
datum. | DATUM_ | the process zone | Text, an IANA zone name such as America/ or UTC. The zone for today() and clock rules. The default is the process zone, read once; when it cannot be read the host uses UTC and warns (datum.). |
datum. | DATUM_ | strip | Word: strip, keep or reject. What an answer with no component in the form does. |
datum. | DATUM_ | warn | Word: off, error, warn, info or debug. How much of a run's log is kept and relayed. |
datum.submissions.idempotency
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | 10000 | Whole number, 16 to 10,000,000. Receipts the in-memory receipt store keeps. |
datum.forms
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | ["datum/ | List of text. Paths and glob patterns of the form definition files, or package:<pkg>/<glob> for files inside an installed package. A location with no glob character names one file. Each file's id is its form key. A file that cannot be read, is not a JSON object, has no valid id, or repeats an id stops the start; a location that matches nothing is a warning in the datum. log. The files are read only when the definition route or the builder is on. |
datum.forms.snapshots
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | 500 | Whole number, at least 1. Snapshots the in-memory store keeps. |
datum. | DATUM_ | 256 | Whole number, at least 1. Public copies of a definition kept by hash. |
datum.forms.translations
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | 1000 | Whole number, at least 1. The number of forms the in-memory translation store holds catalogues for. |
datum.forms.data_sources
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | 15 s | Seconds, at least 0.001. One deadline for all the data-source calls made while building a snapshot. |
datum. | DATUM_ | 16 | Whole number, at least 1. Threads for data-source providers that are plain (synchronous) functions. |
datum.forms.cache
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | no-store | Text. The Cache-Control header of a definition answer. |
datum.web.api
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | 1 | Size, at least 1 byte. The largest request body. It is also the largest document the services read. |
datum. | DATUM_ | false | Boolean. When true, errors are answered as RFC 9457 problem details. |
datum. | DATUM_ | 5 | Whole seconds, 1 to 3600. The Retry-After of a busy answer. |
datum. | DATUM_ | X-Request-ID | Text, an HTTP header name. The header that names a request in the logs. |
datum.web.api.endpoints
One switch per endpoint. Every endpoint is off until its switch is set to true. A router adds a route only when its switch is on.
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | false | Boolean. POST /api/. |
datum. | DATUM_ | false | Boolean. POST /api/. |
datum. | DATUM_ | false | Boolean. POST /api/. |
datum. | DATUM_ | false | Boolean. Definition inspection, POST /api/. |
datum. | DATUM_ | false | Boolean. GET /api/. |
datum. | DATUM_ | false | Boolean. GET /api/. |
datum. | DATUM_ | false | Boolean. POST /api/. |
datum. | DATUM_ | false | Boolean. POST /api/. |
datum. | DATUM_ | false | Boolean. POST /api/. |
datum. | DATUM_ | false | Boolean. POST /api/. |
datum. | DATUM_ | false | Boolean. The signing certificate route, GET /api/. |
datum.web.throttle
Request throttling. Without datum., one limit and one window apply to every kind of request.
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | true | Boolean. Throttle requests. |
datum. | DATUM_ | 60 | Whole number, at least 1. Requests per window. |
datum. | DATUM_ | 60 s | Seconds, at least 1. The length of the window. |
datum. | DATUM_ | ["ip", "form"] | List of words: ip, form, principal; at least one. What a throttle key is made of. |
datum. | DATUM_ | 10000 | Whole number, at least 1. The most distinct keys the in-memory counters hold. |
datum. | DATUM_ | none | Mapping from a kind (submit, validate, test, pdf, register) to requests per window, at least 1. A kind not listed uses limit. |
datum. | DATUM_ | async+memory:// | Text. A storage address of the limits library; use async+redis://... in production. Any credentials in it are hidden in logs. A storage that cannot be built stops the start (datum.). |
datum. | DATUM_ | unset | Secret, at least 32 bytes. Salts the keys in the storage. Required when the storage is not memory, and every worker on one storage must share it (datum.). Memory storage uses a random salt per process. |
datum.web.assets
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | false | Boolean. Serve the packaged browser files, host. and datum-host.. |
datum. | DATUM_ | 31536000 s | Seconds, 0 or more. The cache lifetime of an asset (one year). |
datum. | DATUM_ | none | List of text. Feature tokens whose files are left out of the served assets. |
datum.web.csrf
The names the page glue reads from host.. Datum adds no CSRF protection itself; these settings only name the header, cookie and meta tag your own protection uses.
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | X-XSRF-TOKEN | Text. The header that carries the token. |
datum. | DATUM_ | XSRF-TOKEN | Text. The cookie that carries the token. |
datum. | DATUM_ | _csrf | Text. The meta tag that carries the token. |
datum.web.openapi
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | true | Boolean. Describe Datum's routes in the application's OpenAPI document. |
datum. | DATUM_ | datum- | Text. The prefix of Datum's OpenAPI tags. |
datum. | DATUM_ | false | Boolean. Add one OpenAPI document per router, served at {prefix}/. |
datum.web.management
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | false | Boolean. Serve POST /recheck. It is guarded by the dependencies you pass to routers.. |
datum.builder
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | false | Boolean. Serve the builder routes. |
datum. | DATUM_ | 1 | Size, 1 byte to 64 MiB. The largest definition a save accepts. |
datum.pdf
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | true | Boolean. The PDF capability. With it on, the start needs datum-core[pdf]. |
datum. | DATUM_ | default | Word: default, standard or all. Which font faces a PDF embeds. |
datum.pdf.seal
The seal preset applied to every PDF the application issues.
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | false | Boolean. Seal issued PDFs. Without a server signing key the start warns (datum.). |
datum. | DATUM_ | none | List of text. The layout ids that are sealed. Empty means all. |
datum. | DATUM_ | no | Word: no, form, annotate or none. The kind of signature. no certifies and allows no change afterwards. form certifies and allows form filling. annotate certifies and allows form filling and annotations. none is an approval signature, not a certifying one. The program's own words form and annotations, false and approval for none, and the numbers 0 to 3 are read as well, whatever the case. |
datum. | DATUM_ | true | Boolean. Ask a timestamp token for each seal made with the server's key, when a timestamp source is set up (datum. otherwise). The test seal of posted answers is never timestamped. |
datum. | DATUM_ | unset | Text. The signature reason. |
datum. | DATUM_ | unset | Text. The signature location. |
datum. | DATUM_ | unset | Boolean. Draw a visible signature. Unset leaves it to the layout. |
datum. | DATUM_ | false | Boolean. Seal the PDFs of posted, unstored answers with the real certificate. Without a server key they keep the test seal. |
datum.pdf.signing
The server's signing key, shared by the seal and POST /api/. The key rules are under the value forms above. Nothing here is needed when the application passes its own pdf_ to Datum.
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | PKCS12 | Word: PKCS12 or PEM. The key file format. |
datum. | DATUM_ | unset | Text. The path of the PKCS#12 key store. For type PKCS12. |
datum. | DATUM_ | unset | Secret. The store's password. |
datum. | DATUM_ | unset | Text. The friendly name of the key's certificate in the store. A check against the certificate; it never chooses one. |
datum. | DATUM_ | unset | Secret. The password of the PEM private key. For type PEM. |
datum. | DATUM_ | unset | Text. The path of the PEM private key. |
datum. | DATUM_ | unset | Text. The path of the PEM certificate chain, the key's own certificate first. |
datum. | DATUM_ | none | List of text. PEM locations (a path or package:<pkg>/<file>) of replaced certificates. The verify route reports a signature by one of them as site_. |
datum. | DATUM_ | none | List of text. PEM locations of the trust anchors the verify route builds a chain to. A location that cannot be read stops the start. |
datum.pdf.signing.tsa
The timestamp client used to timestamp PDF signatures. It is not used when the application passes its own timestamper to Datum; setting it then raises datum. or datum..
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | unset | Text. The address of the timestamp authority, http or https. User-info in it is hidden in logs. |
datum. | DATUM_ | unset | Text, an OID such as 1.. The policy requested. |
datum. | DATUM_ | unset | Secret. A bearer token for the authority. |
datum. | DATUM_ | unset | Text. The Basic-auth user. Needs basic_. |
datum. | DATUM_ | unset | Secret. The Basic-auth password. Needs basic_. |
datum. | DATUM_ | 10 s | Seconds, at least 0.001. The bound on one request. |
datum.bindings
Which design-system binding draws each form route, and the PDF theme its PDF prints under. A route is a form key without a version. Use the TOML file for keys with capitals.
[bindings]
default = "datum"
[bindings.routes]
intake = "acme"
[bindings.catalog.acme]
label = "Acme"
pdf_theme = "acme-pdf"
[bindings.pdf_themes]
acme-pdf = "themes/acme-pdf.json"| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | datum | Text. The binding of a route with no override. It must be an id in the catalogue. |
datum. | DATUM_ | none | Mapping from a form key to the binding id that draws it. Every id must be in the catalogue. |
datum. | DATUM_ | none | Mapping from a binding id to its entry (the two rows below). Adds bindings this host registers on its pages to the ones the bundles carry. An id holds letters, digits, ., _ and -. |
datum. | DATUM_ | the id | Text. Shown where bindings are listed. |
datum. | DATUM_ | none | Text, a PDF theme id. The theme a PDF of a route drawn by this binding prints under. Unset suggests none. |
datum. | DATUM_ | none | Mapping from a PDF theme id to the path of its JSON file, for every suggested PDF theme except datum-pdf. The file is a JSON object whose id is the key and whose target is pdf. |
datum.tsa
The RFC 3161 timestamp server. The routes are on only when datum. is true.
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | false | Boolean. Serve the timestamp route. Needs datum-core[timestamp] and datum.. |
datum. | DATUM_ | clients | Word: clients or open. Who may call: only clients that present a known key, or anyone. |
datum. | DATUM_ | unset | Text, an OID. The policy the server issues under. |
datum. | DATUM_ | none | List of OIDs. The policies a request may ask for. |
datum. | DATUM_ | 1 s | Seconds, 0 to 60. The accuracy stated in each token. |
datum. | DATUM_ | 16 | Size, 1 byte to 1 MiB. The largest request. A larger one answers 413. |
datum. | DATUM_ | ["*"] | List of text. A request that carries one of these cookies is refused with 403. The default "*" refuses any cookie. Name cookies instead to refuse only those. Names are matched without regard to case. |
datum. | DATUM_ | false | Boolean. Acknowledge that the serial allocator and issue log are kept in memory, which is safe for one instance only. Without it the start stops (datum.); with it the start warns (datum.). |
datum. | DATUM_ | settings | Word: settings or sql. Where timestamp clients are kept. sql needs a client store passed to Datum. |
datum. | DATUM_ | none | List of 64-character hexadecimal strings. The SHA-256 of each client key, for client store settings. |
datum. | DATUM_ | none | List of text. PEM locations of replaced timestamp certificates. |
datum.tsa.flood
Flood control of the timestamp server.
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | 1000 | Whole number, 0 or more. Requests per window, counted per client (per address under open access). Over it the answer is 429. 0 turns it off. |
datum. | DATUM_ | 3600 s | Seconds, at least 1. The length of the window. |
datum. | DATUM_ | 10 | Whole number, 0 or more. Wrong keys tolerated per address per window; past it the answer is 429. 0 turns the lockout off. |
datum.tsa.signer
The timestamp server's signing key. The key rules are under the value forms above.
| Setting | Environment variable | Default | Meaning |
|---|---|---|---|
datum. | DATUM_ | PKCS12 | Word: PKCS12 or PEM. The key file format. |
datum. | DATUM_ | unset | Text. The path of the PKCS#12 key store. |
datum. | DATUM_ | unset | Secret. The store's password. |
datum. | DATUM_ | unset | Text. The friendly name of the key's certificate in the store. Checked against the certificate, never used to choose it. |
datum. | DATUM_ | unset | Secret. The password of the PEM private key. |
datum. | DATUM_ | unset | Text. The path of the PEM private key. |
datum. | DATUM_ | unset | Text. The path of the PEM certificate chain. |
datum. | DATUM_ | false | Boolean. Use a throwaway self-signed key, for development only. Refused when a key file is named as well. |
Start-up checks
The host runs its checks when the lifespan starts and logs each one under datum. as (datum., with a HINT: line when there is one. A WARNING or INFO check never stops the start. All ERROR checks found are raised together as one Datum and the start stops. List ids in datum. to leave out an INFO or WARNING check.
| Id | Severity | Cause | What to do |
|---|---|---|---|
datum. | INFO | The log line that names the routes that are on: the endpoint switches that are true, and assets. | Nothing. If it reads none, set datum. or datum.. |
datum. | INFO | datum. names an address or credentials, and the application also passed its own timestamper, which issues the tokens instead. | Unset the client settings, or do not pass Datum(timestamper=...). |
datum. | WARNING | A router was included and every switch it reads is off (or datum. is false), so it serves no route. | Set one of the named switches, or do not include the router. |
datum. | WARNING | The runtime's slots times their memory, for the validation and PDF pools and every worker, exceed the container's memory limit (cgroup, else the host's memory) less what the process uses at start. | Lower datum., datum. or the memory budgets, raise the container memory, or state datum.. |
datum. | WARNING | A submission route is on and the default logging handler is in use, which keeps nothing. | Pass your own Datum(handler=...). |
datum. | WARNING | A store is kept in this process's memory: the throttle counters, the receipt store, the snapshot or translation store, or the builder's form repository. Each worker has its own, and a restart forgets them. | Use a shared throttle storage (async+redis://...), give Datum SQL stores or your own, or run one worker. |
datum. | WARNING | Declared for an engine over in-memory SQLite. Nothing raises it. | None. |
datum. | WARNING | A data-source provider keeps the default exists, so it answers for every id and hides the providers after it. | Implement exists on the provider. |
datum. | WARNING | A DATUM_ environment variable matches no setting. The hint offers the closest name. | Fix the name, or remove the variable. Set datum. to stop the start on one. DATUM_ is the only name outside the settings that is allowed. |
datum. | WARNING | A datum. budget was outside its bounds and was moved to the nearest bound. The message gives the value asked, the value used and the bounds. | Set a value inside the bounds listed above. |
datum. | WARNING | The timestamp server keeps its serial allocator or issue log in memory because datum. says so. | Run one instance, or give Datum a SQL store or your own to share between instances and restarts. |
datum. | WARNING | The process time zone could not be read, so datum. is UTC. | Set datum. to an IANA zone name. |
datum. | WARNING | The seal asks for timestamps, a server key is present, and no timestamp source is set up. Sealed PDFs carry the sealing. warning and no token. | Pass Datum(timestamper=...), set datum., enable datum., or set datum. to false. |
datum. | WARNING | datum. is set, and the application's own timestamper issues the tokens, so the policy is unused. | Unset the policy, or do not pass Datum(timestamper=...). |
datum. | WARNING | datum. is on and the server has no signing key, so posted answers carry the test seal and render_ answers 500. | Name a key in datum., or pass Datum(pdf_. |
datum. | ERROR | The timestamp server would keep its serial allocator or issue log in memory, and that is not acknowledged. | Pass a SQL engine and create the table, provide your own store, or set datum. to true for one instance. |
datum. | ERROR | The builder is on with in-memory stores and more than one worker is expected, so a save on one worker is invisible on the others. | Give Datum shared stores, or set datum. to 1. |
datum. | ERROR | A runtime memory budget is below what the runtime module needs to start (its initial pages times 64 KiB). The message gives the least value. | Raise datum. or datum. to at least that value. |
datum. | ERROR | The runtime did not start within datum.. The message names the phases finished so far. | Raise datum., or give the host more CPU: compiling the sandbox module takes seconds on a small virtual machine. |
datum. | ERROR | The throttle counts in a shared storage and datum. is not set. | Set key_ to a secret of at least 32 bytes, the same on every worker. |
datum. | ERROR | The throttle storage cannot be built: a missing client library or an unusable address. The message names the failure's class, never its text. | Install the client library (for example the redis extra of limits), or fix datum.. |
W003, W004, E005 and E006 are raised only while a submission route (submissions, validate, test or inspect) is on. W004 for the snapshot, translation and builder stores is raised while the definition route or the builder is on.