Kubernetes IN Docker - local clusters for testing Kubernetes

★ 15,617⑂ 1,834👁 142⑃ 2,212● 2,066▤ 39
GoApache-2.0Created 2018-09-12kind.sigs.k8s.io/
Download: v0.33.0v0.33.0 ↓0.33.02026-08-26
-1
Daily
15,617
stars
1,834
forks
142
watchers
2,212
prs
2,066
issues
39
releases

README

Please see Our Documentation for more in-depth installation etc.

kind is a tool for running local Kubernetes clusters using Docker container "nodes".
kind was primarily designed for testing Kubernetes itself, but may be used for local development or CI.

If you have [go] and [docker], [podman] or [nerdctl] installed go install sigs.k8s.io/[email protected] && kind create cluster is all you need!

!

kind consists of:
- Go [packages][packages] implementing [cluster creation][cluster package], [image build][build package], etc.
- A command line interface ([kind][kind cli]) built on these packages.
- Docker [image(s)][images] written to run systemd, Kubernetes, etc.
- [kubetest][kubetest] integration also built on these packages (WIP)

kind bootstraps each "node" with [kubeadm][kubeadm]. For more details see [the design documentation][design doc].

NOTE: kind is still a work in progress, see the [1.0 roadmap].

 Installation and usage

For a complete [install guide] see [the documentation here][install guide].

You can install kind with go install sigs.k8s.io/[email protected].

NOTE: please use the latest go to do this. KIND is developed with the latest stable go, see .go-version for the exact version we're using.

This will put kind in $(go env GOPATH)/bin. If you encounter the error
kind: command not found after installation then you may need to either add that directory to your $PATH as
shown here or do a manual installation by cloning the repo and run
make build from the repository.

Without installing go, kind can be built reproducibly with docker using make build.

Stable binaries are also available on the [releases] page. Stable releases are
generally recommended for CI usage in particular.
To install, download the binary for your platform from "Assets" and place this
into your $PATH:

On Linux:

console
 For AMD64 / x86_64
[ $(uname -m) = x86_64 ] && curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.33.0/kind-$(uname)-amd64
 For ARM64
[ $(uname -m) = aarch64 ] && curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.33.0/kind-$(uname)-arm64
chmod +x ./kind
sudo mv ./kind /usr/local/bin/kind


On macOS via Homebrew:

console
brew install kind


On macOS via MacPorts:

console
sudo port selfupdate && sudo port install kind


On macOS via Bash:

console
 For Intel Macs
[ $(uname -m) = x86_64 ] && curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.33.0/kind-darwin-amd64
 For M1 / ARM Macs
[ $(uname -m) = arm64 ] && curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.33.0/kind-darwin-arm64
chmod +x ./kind
mv ./kind /some-dir-in-your-PATH/kind


On Windows:

powershell
curl.exe -Lo kind-windows-amd64.exe https://kind.sigs.k8s.io/dl/v0.33.0/kind-windows-amd64
Move-Item .\kind-windows-amd64.exe c:\some-dir-in-your-PATH\kind.exe

 OR via Chocolatey (https://chocolatey.org/packages/kind)
choco install kind


To use kind, you will need to [install docker].
Once you have docker running you can create a cluster with:

console
kind create cluster


To delete your cluster use:

cons

Top issues

Latest release

v0.33.0 v0.33.0 2026-08-26
This release contains critical dependency updates, bug fixes, and defaults to Kubernetes 1.37.0.

 Breaking Changes

The default node image is now  kindest/node:v1.37.0@sha256:a1ed56cfb0e7b93589bdf97c8cd566405a265939e3620fc4f5de89adff580ae5.

 New Features

 Assorted dependency updates.

Images pre-built for this release:

 v1.37.0: kindest/node:v1.37.0@sha256:a1ed56cfb0e7b93589bdf97c8cd566405a265939e3620fc4f5de89adff580ae5
 v1.36.4: kindest/node:v1.36.4@sha256:099e049362a1526b2db71494e1947aae99bd16290d7c895f2b7ea312e3cbfaed
 v1.35.8: kindest/node:v1.35.8@sha256:07b2536e30b803ed6

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON