Configuration

Every DataPress instance reads a single TOML file at startup. By convention it's called datasets.toml; override with the DATASETS_CONFIG environment variable.

It has one [server] block and one [[dataset]] block per table you want to expose.

[server]                  # optional; defaults shown below
backend = "datafusion"    # or "duckdb"
listen  = "127.0.0.1"
port    = 8080

[[dataset]]               # one block per dataset
name = "..."
# source, s3, index, lazy follow

Pages

• Server settings — listen, port, workers, prefix, compression, body limits, timeouts, graceful shutdown.
• Datasets — source, lazy, parquet vs delta, local files, directories, globs.
• S3 / object storage — credentials, endpoints, addressing styles, per-dataset env overrides.
• Indexing — DataFusion equality-index policy.
• Documentation site — enabling the embedded MkDocs site.