Skip to content
Documentation
Configuration

Configuration

All configuration is done via CLI flags or environment variables. Every flag has a corresponding environment variable with the STREAMBED_ prefix.

Source Database

FlagEnv VarDescription
--source-urlSTREAMBED_SOURCE_URLPostgres connection string

The source database must have logical replication enabled (wal_level = logical).

S3 / Object Storage

FlagEnv VarDescription
--s3-bucketSTREAMBED_S3_BUCKETS3 bucket name
--s3-prefixSTREAMBED_S3_PREFIXKey prefix for Iceberg data
--s3-endpointSTREAMBED_S3_ENDPOINTCustom S3 endpoint (for MinIO, etc.)
--s3-regionSTREAMBED_S3_REGIONAWS region

Flush Behavior

FlagEnv VarDefaultDescription
--flush-rowsSTREAMBED_FLUSH_ROWS10000Flush after this many buffered rows
--flush-intervalSTREAMBED_FLUSH_INTERVAL2sFlush after this time interval

Query Server

FlagEnv VarDescription
--query-addrSTREAMBED_QUERY_ADDRAddress for the Postgres-compatible query server (e.g. :5433)
CommandsArchitecture