00 Setup

Facilitator companion to the learner lesson 00 Setup.

Timing

About 25 minutes. Kick off the fire-and-wait steps (create the service, docker compose up) before or during the opening talk so they run underneath it. Push attendees to do the three account signups (ClickHouse Cloud, Langfuse, OpenAI) before the day - each is 5 to 10 minutes - so this module stays inside budget.

Talk track

• Frame the session: they will move an existing app onto ClickHouse Cloud, and the agent does the building.
• The CLI returns the default-user password once; have learners save it immediately. The service Connect dialog provides the hostname.
• Module 00 now creates the Cloud service and fills every credential, so the fire-and-wait is front-loaded here; module 01 just builds the schema on the service that already exists.
• Step 7 is the only agent-integration setup: skills, ClickHouse MCP, and ClickStack MCP.

Common failures

• Work email already attached to an existing ClickHouse org, so no trial credits appear. Steer to a personal email (surfaced in prework).
• Coding agent cannot add MCP servers due to corporate policy (surfaced by the prework smoke test).
• docker compose up fails because Docker is under-allocated (needs 6 GB+).
• The first request after a Cloud service idle-scales to zero used to 500; the back end now retries the idle-wake on connect, so the first dashboard load may pause a few seconds but succeeds. Not a failure to chase. Confirmed in the 2026-07 clean-room dry run.

Reset steps

• Point a stuck attendee at the loaner Cloud service pool if their trial is unusable.
• Re-run cp .env.workshop.example .env.workshop and re-fill; confirm no stray committed .env.workshop.
• TODO: confirm reset commands.