Kwok
KWOK is a lightweight Kubernetes cluster simulator that creates fake nodes, pods, and other Kubernetes resources without kubelet, letting developers and…
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
Variants
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
- Introducing KWOK: Kubernetes WithOut Kubelet : r/kubernetes - Reddit (reddit)
- Simulation of thousands kube clusters with KWOK (forum)
- [Help] Is there a way to set node/pod status update frequency for kwok ... (forum)
Collected 48 days ago - public community threads