kwok

Kubernetes SIGs·Kubernetes.kwok

A toolkit that enables setting up a cluster of thousands of Nodes in seconds.

KWOK is a toolkit that enables setting up a cluster of thousands of Nodes in seconds. Under the scene, all Nodes are simulated to behave like real ones, so the overall approach employs a pretty low resource footprint that you can easily play around on your laptop.

winget install --id Kubernetes.kwok --exact --source winget

Latest 0.8.0·June 23, 2026

Release Notes

Changes by Kind API Change or Feature

  • Add steps to stage instead of next (#1403, @wzshiming)
  • [kwokctl] Add subcommand config convert for upgrade old config (#1471, @wzshiming)
  • Support IPv6 CIDR/IP (#1656, @wzshiming)
  • Update default CIDR values from x.x.x.1/24 to x.x.x.0/24 (#1578, @wzshiming)
  • Support resource creation for stage api Support volume provisioner (#1617, @wzshiming)
  • Support impersonate for pod/node in stage (#1629, @wzshiming)
  • Change pod fast stage (#1640, @wzshiming)
    • Respect delete finalizers
    • Use conditions instead of podIP to check if the pod is ready
  • [kwokctl] Add optional components to container runtime (docker/podman/nerdctl):
    • kueue (#1513, @wzshiming)
    • kueueviz (#1516, @wzshiming)
    • jobset (#1537, @JerryHu1994)
    • lws (#1610, @Copilot)
    • descheduler (#1615, @Copilot)
    • scheduler-plugins (#1661, @wzshiming)
      • When enabled, the default kube-scheduler will be replaced by the kube-scheduler from scheduler-plugins, so the configuration can be passed using --kube-scheduler-config.
  • [kwokctl] Add a warning log when enable/disable unsupport component (#1612, @wzshiming)
  • [kwokctl] Support completion (#1618, @wzshiming) Bug or Regression
  • Add selector for pod readiness based on phase 'Pending' (#1509, @anson627)
  • Fix the issue when kube-scheduler crash: "clientConnection" already set in map (#1447, @anson627)
  • Fix port forward target address cannot be ipv6 (#1449, @wzshiming)
  • [kwokctl] Fix metrics server on container runtime (#1557, @wzshiming)
  • [kwokctl] Fix mount previousLogsFile (#1405, @wzshiming)
  • [kwokctl] Fix port forward in container runtime (#1627, @wzshiming) Other (Cleanup or Flake)
  • Remove subcommand hack and use kectl instead (#1502, @wzshiming)
  • Remove KWOK_MODE in controller, feature is deprecated in k8s 1.29. (#1599, @wzshiming)
  • Remove cni in controller (#1600, @wzshiming)
  • Remove the built-in default stage (#1496, @wzshiming) Images kwok
  • registry.k8s.io/kwok/kwok:v0.8.0 cluster
  • registry.k8s.io/kwok/cluster:
    • v0.8.0-k8s.v1.36.1
    • v0.8.0-k8s.v1.35.5
    • v0.8.0-k8s.v1.34.8
    • v0.8.0-k8s.v1.33.12
    • v0.8.0-k8s.v1.32.13
    • v0.8.0-k8s.v1.31.14
  • ghcr.io/kwok-ci/cluster:
  • kwok 0.3.0
  • stage-fast 0.3.0
  • metrics-usage 0.3.0 Contributors Thank you to everyone who contributed to this release! ❀️ Users whose commits are in this release (alphabetically by user name) Contributors since v0.7.0:
  • @anson627
  • @arpitjain099
  • @ChrsMark
  • @Copilot
  • @immanuwell
  • @JerryHu1994
  • @k8s-ci-robot
  • @wzshiming And thank you very much to everyone else not listed here who contributed in other ways like filing issues, giving feedback, etc. πŸ™

Installer type: portable

ArchitectureScopeDownloadSHA256
x64β€”Download82AE828DF35E82BE1A5B301FD5C1ABE20F533AB0E1FAC7F0C9DA95C62ABC6758
arm64β€”DownloadD6C4B577184656CB509F6C8CFB758A5046A9BE53BFD3FD65175AD48A188FA1ED

Details

Homepage
https://kwok.sigs.k8s.io/
License
Apache-2.0
Publisher
Kubernetes SIGs
Support
https://github.com/kubernetes-sigs/kwok/issues
Copyright
Copyright 2026 The Kubernetes Authors.
Moniker
kwok

Tags

clustercontainerdockerk8skubernetes

Older versions (5)

0.7.0
ArchitectureScopeDownloadSHA256
x64β€”Download4A90E5DAE3171AF28D81B07AB502D7C4E70A911A14801DBE19684643158FEBCF
arm64β€”Download481CBD203ECEEA368CBEE63E47B0B0CC2FC51920350689EDF6A77D166C5A2E29
0.6.1
ArchitectureScopeDownloadSHA256
x64β€”Download3771377B85FD57A3848A528D99A4574BC9AB5D28C31FA159983BCE80D528A513
arm64β€”DownloadF9674CB0858B8B754464B82D27A7C1C15D5ABC231909330B7FCD52285DA19167
0.5.2
ArchitectureScopeDownloadSHA256
x64β€”Download62DCC4F12898B3173C31B4D5BBDAF53284BFE05918F8F24C5CD442B83FAE70C2
arm64β€”Download559762AA613ECB5FEFC26F62C3D835467DEDF9454661C311FF7FD7A265BBC935
0.5.1
ArchitectureScopeDownloadSHA256
x64β€”Download0E003366E11787699D67256701D62E0DB8C14189F0D2D6F57B5F7DF3BD558412
arm64β€”Download9320FB536E675D332E0A2F394379DC6A66F2FCD185A5BD033F652CAB3731C4EC
0.4.0
ArchitectureScopeDownloadSHA256
x64β€”Download19276C13F5607F6BB08A666D00E827CEC2C4162713E6D762705E3AE905F6B02B
arm64β€”Download11DED7B714A68A4A44439C066AF2A08DC2ACFF75743394E699115787C107FFAB