Installation

Most users: sign up for Causet Cloud — managed hosting with no local infrastructure. The self-hosted Docker stack below is for team contributors with private source access.

Prerequisites

RequirementVersionNotes
Docker DesktopLatestRequired for local stack
curl + jqAnyUseful for health checks

Java services run as pre-built Docker images. You do not need Java or Gradle installed locally. Compile DSL with the causet CLI only.

Install the Causet CLI

curl -fsSL https://raw.githubusercontent.com/Causet-Inc/causet-cli/main/install.sh | sh
causet version

See Install Causet for sign-in and next steps. The CLI bundles the compiler:

causet build compile --runtime path/to/my-app --out build/tmp-out

Self-hosted stack (team contributors)

Source and Docker Compose configuration are private. After you receive repository access:

git clone <your-internal-remote>
cd Causet
docker compose up -d

This starts:

ComponentPortPurpose
PostgreSQL (causet DB)5432Event store — ledger_events, entity_snapshots
PostgreSQL (projections DB)5433Projection tables per tenant schema
Redpanda9092Kafka-compatible broker for projection events
MinIO9000Local S3 — stores compiled IR artifacts
causet-runtime-service8080, 9090Intent processing, rules engine
causet-saas-cloud8085Sessions, releases, active IR version
causet-projection-worker8083Kafka consumer → projection UPSERTs
causet-query-service8082Named + entity queries
causet-cloud-control-plane3000Web UI + API proxy
causet-realtime-go8081WebSocket + SSE fanout

Wait for services to be healthy (~60–90 seconds):

curl -s http://localhost:8080/actuator/health | jq .status
curl -s http://localhost:8082/actuator/health | jq .status
curl -s http://localhost:8083/actuator/health | jq .status

All should return "UP".

Rebuild a service after code changes:

docker compose build causet-runtime-service
docker compose up -d causet-runtime-service

Verify your setup

Once everything is running, open the control plane:

http://localhost:3000

You should see the Causet control plane UI. From here you can:

  • Create a platform and application
  • Upload compiled IR artifacts
  • Create and deploy a release
  • Browse the entity ledger
  • Run queries

Next steps

What is Causet?