Stream Stack

Stream Stack is durable, addressable, real-time streams over HTTP, built on S3-compatible object storage.

Join the Discord for questions, ideas, and development updates.

Installation

Java 17+ and Maven. Docker (Optional)

mvn clean package

Quickstart

Stream Stack (native protocol):

cp harness/local/.env.example harness/local/.env
docker compose --env-file harness/local/.env \
  -f harness/local/docker-compose.minio.yml \
  -f harness/local/docker-compose.native.yml \
  up -d --build

Durable Streams:

cp harness/local/.env.example harness/local/.env
docker compose --env-file harness/local/.env \
  -f harness/local/docker-compose.minio.yml \
  -f harness/local/docker-compose.ds.yml \
  up -d --build

Node listens on 127.0.0.1:4437. Admin plane and dashboard: 127.0.0.1:9090. Cluster, AWS, and Fly deployments are covered in the docs.

Deployment

Create data and WAL S3 buckets. Copy harness/aws/.env.example to harness/aws/.env and fill AWS_*, DATA_BUCKET, and WAL_BUCKET.

Stream Stack (native protocol):

docker compose --env-file harness/aws/.env \
  -f harness/aws/docker-compose.native.yml \
  up -d --build

Durable Streams:

docker compose --env-file harness/aws/.env \
  -f harness/aws/docker-compose.ds.yml \
  up -d --build

Node listens on 127.0.0.1:4437. Three nodes: harness/aws/docker-compose.cluster.native.yml or harness/aws/docker-compose.cluster.ds.yml.

Multi-node (3 nodes) local cluster (ports 4437–4439), swap native for ds to serve Durable Streams:

docker compose --env-file harness/local/.env \
  -f harness/local/docker-compose.minio.yml \
  -f harness/local/docker-compose.cluster.native.yml \
  up -d --build

License

Apache 2.0.