VOL · 00

Getting started: setting up a Jōkamachi cluster

From zero to a self-hosted Jōkamachi Kubernetes cluster on Hetzner.

Chapters 1

Stub. Chapters to follow.

The booklet you read first if you’re going to run Jōkamachi yourself under the Free plan, or if you just want to see how the platform is put together before deciding whether to use the Managed or Agentic plan.

It covers, in order:

  1. Prerequisites. A Hetzner account, a domain you control, and kubectl on your laptop.
  2. Bootstrapping the control plane. Running the bootstrap scripts against a fresh set of Hetzner cloud VMs (or bare-metal servers).
  3. Adding worker pools. Mixing cloud VMs and dedicated servers in the same cluster.
  4. Day-2 hand-off. Wiring up monitoring, automatic backups, and the dashboard — or skipping the dashboard and reading raw Prometheus, if you’d rather.
  5. Where to go next. Pointers into the architecture and KAOS booklets for deeper reading.

Plain-English, low-effort, no prior Kubernetes experience assumed.

  1. 01
    Overview What this booklet covers and who it's for.
    1 min