Hive
docs(server): update self-host Docker Compose to use Kura
GitHub issue · Closed
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 pgwebdocker --context=default compose -p "$project" --env-file "$tmpdir/.env" -f "$tmpdir/docker-compose.yml" up -d --waitwith a valid self-host license and the locally built Tuist image- Health checks passed for Tuist
/ready, Kura/up, ClickHouse/ping, MinIO readiness, and Postgrespg_isready sh -n server/rel/overlays/bin/startgit diff --checkgit diff --check origin/main...HEAD