Kwok

KWOK is a lightweight Kubernetes cluster simulator that creates fake nodes, pods, and other Kubernetes resources without kubelet, letting developers and…

  • Development
  • Infrastructure
  • Tools & Utilities
KWOK is a lightweight Kubernetes cluster simulator that creates fake nodes, pods, and other Kubernetes resources without kubelet, letting developers and automation systems test large clusters with low resource usage.

Platform availability

Available on 1 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

73/100 Good

Maintained
100last commit 24 days ago
Popular
703,217 GitHub stars
Easy to install
251 install platform, install notes
Light to run
No data
Security check
70no serious findings, 5 minor, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today

GitHub stars
3,217
Open issues
47
Last commit
2026-10-28
Latest release
v0.8.0
License
Apache-2.0
Activity
declining

Checked 14 days ago - source: GitHub (kubernetes-sigs/kwok)

Resources & Compatibility

Requirements not published yet.

First-install notes

  • Install kwok and kwokctl first Use Homebrew to install both kwok and kwokctl on Linux or macOS with brew install kwok. Without these tools, the commands below won't exist and you can't start a cluster. source
  • Start the cluster and wait Run kwokctl start cluster, and consider adding --wait so it reports only after the cluster is ready. If you skip waiting, you may try to connect too early and get errors. source
  • Keep the default config file By default, kwokctl looks for settings in ~/.kwok/kwok.yaml. Don't delete or move that file after setup, because it is where your cluster configuration lives and losing it can break future starts. source

Fetched 41 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How much RAM does one simulated KWOK cluster use?

A user reports that each simulated Kubernetes cluster uses about 250 MB of RAM and asks how to reduce memory usage when simulating many clusters.

Can I control how often KWOK updates node or pod status?

The source is a user asking whether there is a way to set the frequency of node and pod status updates, or heartbeats, sent by KWOK running outside a cluster to the API server.

Is KWOK meant to replace a real Kubernetes distribution?

The Reddit thread says KWOK simulates the lifecycle of fake nodes, pods, and other Kubernetes API resources, and is for testing other Kubernetes machinery such as operators rather than a leaner distribution.

Which KWOK tool should I use to create clusters?

kwokctl is a CLI tool designed to streamline the creation and management of clusters, while kwok simulates the lifecycle of fake nodes, pods, and other Kubernetes API resources.

Answers sourced from discuss.kubernetes.io, discuss.kubernetes.io, github.com, www.reddit.com

Community

Collected 48 days ago - public community threads