Kalisto/ documentation source (permission required) ↗
On this page

#Kalisto documentation

Kalisto is a local-development Kubernetes runtime using k3s on macOS and Linux. These guides are the consolidated product documentation, migrated from the source README and operational guides at revision eb21785.

#Choose a backend

Host Backend Preparation
Apple silicon, macOS 26+ Apple containers, the macOS default Installed Apple container CLI and running service; prepared kernel/init and Ubuntu/k3s OCI node image
Intel Macs or older macOS; explicit alternative on supported Macs Native Lima VZ, Rosetta opt-in Managed Lima runtime and sanitized VM disk/template
Linux Firecracker, the Linux default Host Firecracker/KVM and rootless networking prerequisites; explicit or configured kernel/rootfs plus prepared read-only boot assets

The default never silently falls back to Lima. Existing clusters retain their recorded backend; selecting a different engine does not convert disks or archives. Kalisto runs its own k3s nodes, not Apple's experimental Kubernetes implementation.

#Start here

  1. Install and start a cluster: obtain a development candidate from the download selector, install the host prerequisites, then prepare and boot.
  2. Preparation and offline boot: understand reusable profiles, explicit Cilium selection and startup without downloads.
  3. CLI and cluster lifecycle: inspect resources, use managed kubectl, stop/resume, scale and delete only owned clusters.
  4. Workloads, add-ons and ingress: apply application manifests and explicitly configure ingress after startup.

#Operational and contributor guides

#Availability and source

Only development candidates are offered here; no stable release is claimed. A compiled package does not establish runtime validation on every architecture. The native Linux Firecracker result was measured on x86_64; native Apple and optional Lima measurements have separate evidence boundaries.

Source is hosted on GitHub. Repository file links in these guides are pinned to the migration revision.