Skip to content

Settings

The headless engine reads <vault>/.datanotes/service.json (or the file given with --settings). Missing keys take their default.

Key Default Meaning
storeFolder ".datanotes" Hidden folder (dot-folder at the vault root) for the journal, transaction log and logs.
journalRetentionDays 90 Journal entries older than this many days are dropped (undo is no longer possible for them).
fileLogEnabled true Write log records to <storeFolder>/logs/<day>.jsonl.
logRetentionDays 30 Log files older than this many days are deleted.
databaseFolder "Database" Root of the database layout: <databaseFolder>/<schema>/<table>/_schema.md. The schema of a table is the folder between this root and the table folder; public otherwise.
tableProperty "table" Row property naming the catalog table a note belongs to (table: personal.metrics.mood).
telemetryEnabled false Send operation logs to an OTLP/HTTP collector (local SigNoz).
telemetryEndpoint "http://127.0.0.1:4318" OTLP/HTTP base URL; logs are POSTed to <endpoint>/v1/logs.
telemetryServiceName "datanotes" service.name resource attribute.
telemetryHeaders {} HTTP headers sent with every export, e.g. {"signoz-ingestion-key": "…"} for SigNoz Cloud or {"Authorization": "Bearer …"} for a collector with a token. Kept in the settings file.
autoRecompute true After a row is edited by hand, recompute its generated / identity columns (a few seconds after the last change, as a journaled recompute operation).
viewNotes true Write a note per view in its schema folder (Database/<catalog>/<schema>/<view>.md, with a ```datanotes block). Off: no view notes, and the generated ones are removed.
semanticEnabled false Semantic search: embed notes with semanticProvider (off by default: content is sent to it).
semanticProvider "ollama" Embedding provider: ollama, lmstudio, openrouter, openai or custom (any OpenAI-compatible API).
semanticBaseUrl "" Empty: the provider’s default URL.
semanticModel "" Embedding model, e.g. nomic-embed-text (Ollama) or openai/text-embedding-3-small (OpenRouter).
semanticScope "vault" “vault”: every note; “tables”: only table rows.
semanticExclude [] Folders left out of the index.
semanticBatchSize 32 Passages per embedding request.
httpServerPort 27150 Port of the HTTP API (on 127.0.0.1 unless the service is told otherwise).
httpServerToken "" The owner’s bearer token (generated at the first start).