Booklets on Jōkamachi Systems

Getting started: setting up a Jōkamachi cluster

Mon, 01 Jan 0001 00:00:00 +0000

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:

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

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

Introduction to the technologies

Mon, 01 Jan 0001 00:00:00 +0000

Stub. Chapters to follow.

A guided tour of the technologies that make a Jōkamachi cluster run: Kubernetes itself, the container runtime, the network plane, storage, ingress, and the supply-chain pieces that sit around them.

Written for someone who has heard of Kubernetes, but has never had to operate one.

Cluster architecture

Mon, 01 Jan 0001 00:00:00 +0000

Stub. Chapters to follow.

The architecture booklet: control plane, worker pools, multi-tenancy, the isolation boundaries between customers, and the deliberately boring networking choices that hold the whole thing together.

The booklet you read before you trust us with your workloads.

Pricing About

KAOS — the Kubernetes Agentic Operator Substrate

Mon, 01 Jan 0001 00:00:00 +0000

Stub. The chapters that exist are stubs too.

KAOS is the Kubernetes Agentic Operator Substrate — the layer agentic operators live in and act through, and the operator that ships with the Agentic pricing tier.

The booklet is structured as a progression from “you don’t need KAOS” to “you actually want KAOS, here’s why”, because that’s the order in which the value becomes apparent. KAOS is not a starting point; it’s a destination you reach after you’ve earned operational experience with the cluster yourself.

Performance profiling Kubernetes on Hetzner

Mon, 01 Jan 0001 00:00:00 +0000

Stub. Chapters to follow.

When you choose Hetzner over a hyperscaler, you also choose a different set of trade-offs. Hetzner’s load balancer behaves differently from AWS NLB; their cloud VMs share CPU cores in ways their dedicated servers don’t; running a custom NAT gateway can save real money or burn real engineering time, depending on the workload.

This booklet puts numbers behind the choices. We benchmark the options against real workloads and publish what we found, so you don’t have to.

Kubenix: stronger primitives for cluster definitions

Mon, 01 Jan 0001 00:00:00 +0000

Stub. The chapters that exist are stubs too.

Kubernetes is the right tool for running production workloads because the world doesn’t stand still. Kubenix is the right tool for describing what you want Kubernetes to run, because hand- stitching Helm charts loses the relationships between services that make a cluster more than the sum of its parts.

The booklet covers both halves of that argument and what they unlock together.