Hive Hive
Sign in

docs(server): update self-host Docker Compose to use Kura

GitHub issue · Closed

Metadata
Source
tuist/tuist #11079
Updated
Jun 24, 2026
Domains
Kura
Details

Resolves N/A

This PR updates the self-host Docker Compose quick start so it runs the Tuist server with Kura instead of the legacy cache-node path. The compose bundle has no Redis or legacy cache-server service. The local cache-node service is Kura only.

It adds a downloadable self-host bundle under server/priv/static/server/self-host/ with Postgres, ClickHouse, ClickHouse Keeper, MinIO, Kura, pgweb, and Tuist wired together. The Tuist container points at Kura through the Docker network via http://kura:4000, while the docs still expose the host-facing Kura HTTP and gRPC ports for local inspection. It also exposes the server/ static download path through TuistWeb.static_paths/0 and updates the self-host control-plane guide to download the new files.

The validation surfaced that the release start script fails on a fresh database because schema_migrations does not exist yet. This PR makes that lookup tolerant so first-time self-hosted compose runs can reach the migration step.

How to test locally

  • docker --context=default buildx build --builder tuist-serial --platform linux/arm64 --load -f server/Dockerfile --build-arg TUIST_HOSTED=0 --build-arg TUIST_VERSION=selfhost-test -t tuist-selfhost:test .
  • docker --context=default compose -p "$project" --env-file "$tmpdir/.env" -f "$tmpdir/docker-compose.yml" config --services, confirming the services are Postgres, ClickHouse Keeper, ClickHouse, Kura, MinIO, MinIO init, Tuist, and pgweb
  • docker --context=default compose -p "$project" --env-file "$tmpdir/.env" -f "$tmpdir/docker-compose.yml" up -d --wait with a valid self-host license and the locally built Tuist image
  • Health checks passed for Tuist /ready, Kura /up, ClickHouse /ping, MinIO readiness, and Postgres pg_isready
  • sh -n server/rel/overlays/bin/start
  • git diff --check
  • git diff --check origin/main...HEAD
Comments
TA
tuist-atlas[bot] Jun 5, 2026

The changes from this PR are now available in release xcresult-processor-image@0.11.0. The self-host Docker Compose documentation has been updated to use Kura.

TA
tuist-atlas[bot] Jun 5, 2026

This change is now available in server@1.206.0. Update to receive the improvement: the self-host Docker Compose setup has been updated to use Kura instead of the legacy cache-node path.