Sankofa Docs
Open app
DocsSelf-hostingDocker Compose deployment
Self-hosting

Docker Compose deployment

Bring up Sankofa and ClickHouse locally using the compose file included in the repository.

Source of truthserver/infra/docker-compose.yml

Included services

The compose file defines:

  • sankofa
  • clickhouse

ClickHouse exposes:

  • 8123 over HTTP
  • 9000 over the native protocol

The Sankofa service depends on ClickHouse health and is behind the full profile.

Start the full stack

cd server/infra
docker compose --profile full up --build

Volumes and state

  • ./sankofa_data:/app/data persists Sankofa data for the engine container
  • ch_data:/var/lib/clickhouse persists ClickHouse data

Compose notes

The checked-in compose file sets:

  • CLICKHOUSE_ADDR=clickhouse:9000
  • CLICKHOUSE_USER=default
  • CLICKHOUSE_PASSWORD=password123
  • CLICKHOUSE_DB=default

Use stronger credentials for any non-local environment.

Previous

Self-hosting

Run Sankofa on your own infrastructure with the engine, ClickHouse, and a small environment surface.

Next

Environment reference

Reference for the engine configuration surface in the checked-in .env example.