Skip to content
canardstack logo canardstack

Serve an Existing DuckLake Catalog

This guide shows you how to start canardstack against DuckLake tables that a DuckDB writer has already populated with duckdb-otlp.

Start the Query Server

Section titled “Start the Query Server”
Terminal window
CANARDSTACK_DUCKLAKE_ATTACH_URI=ducklake:/path/to/catalog.ducklake \
CANARDSTACK_DUCKLAKE_DATA_PATH=/path/to/ducklake-data \
CANARDSTACK_API_KEY=dev-canardstack-key \
canardstack serve --listen 127.0.0.1:9090

Check Health

Section titled “Check Health”
Terminal window
canardstack healthcheck --endpoint http://127.0.0.1:9090/healthz

The health check must be able to attach DuckLake and prepare a read query against otlp_logs.

Query a Route

Section titled “Query a Route”
Terminal window
curl -sS -H 'Authorization: Bearer dev-canardstack-key' \
  http://127.0.0.1:9090/loki/api/v1/labels

For exact route contracts, see HTTP API reference.