BUILD WorkshopClickHouse Workshops

02 Base app

Instructor notes for module 02 — timing, talk track, common failures, and reset steps.

Your computer
macOS terminal: Run workshop commands in Terminal using zsh or bash.

Facilitator companion to the learner lesson 02 Base app.

Timing

About 5 minutes. Keep this short; it is orientation, not construction, and buys time for services and telemetry to warm up.

Talk track

  • Walk the two dashboards on the projector: Ops (live) versus Historical (large ranges).
  • Point out the chat panel and set the expectation that it is wired up in module 08.
  • Name the data flow so the later modules have a shared vocabulary.
  • TODO: expand.

Common failures

  • Front end not reachable at http://localhost:8080/ because the stack is not healthy yet; have them run docker compose ps.
  • The 2026-07 clean-room dry run covered this module; validated failure modes, timings, and human-gated steps were confirmed in the 2026-07 clean-room dry run.

Reset steps

  • docker compose down && docker compose up -d to recover an unhealthy stack.
  • TODO: confirm reset commands.

On this page