Skip to main content

Configuration

Thermocline configuration is environment-variable-first, with local defaults in docker-compose.yml.

Primary Configuration Surfaces

  1. Local compose runtime: docker-compose.yml
  2. Gateway static defaults: services/gateway/config/default.toml
  3. Helm values: deploy/helm/thermocline/values*.yaml
  4. Terraform variables: deploy/terraform/*/variables.tf

Key Local Environment Variables

Gateway

  • GATEWAY_LISTEN_ADDR
  • GATEWAY_ADVERTISED_HOST
  • GATEWAY_COORDINATOR_ADDR
  • GATEWAY_SE_ADDR
  • GATEWAY_MAX_CONNECTIONS
  • GATEWAY_IDLE_TIMEOUT_SECS

Storage Engine

  • SE_DATA_DIR
  • SE_GRPC_ADDR
  • SE_METRICS_PORT
  • SE_WAL_SYNC_MODE
  • SE_MEMTABLE_SIZE
  • SE_BLOCK_CACHE_SIZE
  • SE_COMPACTION_THREADS

Coordinator

  • COORDINATOR_GRPC_ADDR
  • COORDINATOR_ETCD_ENDPOINTS
  • COORDINATOR_QE_ADDRS
  • COORDINATOR_SE_ADDRS

Query Engine

  • GRPC_LISTEN_ADDR
  • STORAGE_PROVIDER
  • STORAGE_BUCKET
  • STORAGE_ENDPOINT
  • STORAGE_ALLOW_HTTP
  • Intelligent cache (query-engine): CACHE_*
  • GPU acceleration (optional storage-engine build): GPU_ACCEL_*
  • ML engine limits/persistence: ML_ENGINE_*, ML_ENGINE_MODEL_STORE_DIR

For complete parameter details, see Configuration Reference.