{"id":25975851,"url":"https://github.com/block-stacker/kind","last_synced_at":"2026-04-21T13:05:02.580Z","repository":{"id":279111742,"uuid":"937765327","full_name":"block-stacker/kind","owner":"block-stacker","description":"Kubernetes IN Docker - local clusters for testing Kubernetes","archived":false,"fork":false,"pushed_at":"2025-02-23T21:08:12.000Z","size":12651,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-05T03:33:20.051Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/block-stacker.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"code-of-conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY_CONTACTS","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-23T20:51:48.000Z","updated_at":"2025-02-25T21:40:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"ff1ef35c-192a-4bd7-a64e-5bf7322c310d","html_url":"https://github.com/block-stacker/kind","commit_stats":null,"previous_names":["savvy-bit/kind","block-stacker/kind"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/block-stacker/kind","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block-stacker%2Fkind","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block-stacker%2Fkind/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block-stacker%2Fkind/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block-stacker%2Fkind/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/block-stacker","download_url":"https://codeload.github.com/block-stacker/kind/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block-stacker%2Fkind/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32093157,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-21T11:25:29.218Z","status":"ssl_error","status_checked_at":"2026-04-21T11:25:28.499Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-05T03:32:22.097Z","updated_at":"2026-04-21T13:05:02.561Z","avatar_url":"https://github.com/block-stacker.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg alt=\"kind\" src=\"./logo/logo.png\" width=\"300px\" /\u003e\u003c/p\u003e\n\n# Please see [Our Documentation](https://kind.sigs.k8s.io/docs/user/quick-start/) for more in-depth installation etc.\n\nkind is a tool for running local Kubernetes clusters using Docker container \"nodes\".\nkind was primarily designed for testing Kubernetes itself, but may be used for local development or CI.\n\nIf you have [go] 1.16+ and [docker], [podman] or [nerdctl] installed `go install sigs.k8s.io/kind@v0.26.0 \u0026\u0026 kind create cluster` is all you need!\n\n![](site/static/images/kind-create-cluster.png)\n\nkind consists of:\n- Go [packages][packages] implementing [cluster creation][cluster package], [image build][build package], etc.\n- A command line interface ([`kind`][kind cli]) built on these packages.\n- Docker [image(s)][images] written to run systemd, Kubernetes, etc.\n- [`kubetest`][kubetest] integration also built on these packages (WIP)\n\nkind bootstraps each \"node\" with [kubeadm][kubeadm]. For more details see [the design documentation][design doc].\n\n**NOTE**: kind is still a work in progress, see the [1.0 roadmap].\n\n## Installation and usage\n\nFor a complete [install guide] see [the documentation here][install guide].\n\nYou can install kind with `go install sigs.k8s.io/kind@v0.26.0`.\n\n**NOTE**: please use the latest go to do this. KIND is developed with the latest stable go, see [`.go-version`](./.go-version) for the exact version we're using.\n\nThis will put `kind` in `$(go env GOPATH)/bin`. If you encounter the error\n`kind: command not found` after installation then you may need to either add that directory to your `$PATH` as\nshown [here](https://golang.org/doc/code.html#GOPATH) or do a manual installation by cloning the repo and run\n`make build` from the repository.\n\nWithout installing go, kind can be built reproducibly with docker using `make build`.\n\nStable binaries are also available on the [releases] page. Stable releases are\ngenerally recommended for CI usage in particular.\nTo install, download the binary for your platform from \"Assets\" and place this\ninto your `$PATH`:\n\nOn Linux:\n\n```console\n# For AMD64 / x86_64\n[ $(uname -m) = x86_64 ] \u0026\u0026 curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.26.0/kind-$(uname)-amd64\n# For ARM64\n[ $(uname -m) = aarch64 ] \u0026\u0026 curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.26.0/kind-$(uname)-arm64\nchmod +x ./kind\nsudo mv ./kind /usr/local/bin/kind\n```\n\nOn macOS via Homebrew:\n\n```console\nbrew install kind\n```\n\nOn macOS via MacPorts:\n\n```console\nsudo port selfupdate \u0026\u0026 sudo port install kind\n```\n\nOn macOS via Bash:\n\n```console\n# For Intel Macs\n[ $(uname -m) = x86_64 ] \u0026\u0026 curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.26.0/kind-darwin-amd64\n# For M1 / ARM Macs\n[ $(uname -m) = arm64 ] \u0026\u0026 curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.26.0/kind-darwin-arm64\nchmod +x ./kind\nmv ./kind /some-dir-in-your-PATH/kind\n```\n\nOn Windows:\n\n```powershell\ncurl.exe -Lo kind-windows-amd64.exe https://kind.sigs.k8s.io/dl/v0.26.0/kind-windows-amd64\nMove-Item .\\kind-windows-amd64.exe c:\\some-dir-in-your-PATH\\kind.exe\n\n# OR via Chocolatey (https://chocolatey.org/packages/kind)\nchoco install kind\n```\n\nTo use kind, you will need to [install docker].\nOnce you have docker running you can create a cluster with:\n\n```console\nkind create cluster\n```\n\nTo delete your cluster use:\n\n```console\nkind delete cluster\n```\n\n\u003c!--TODO(bentheelder): improve this part of the guide--\u003e\nTo create a cluster from Kubernetes source:\n- ensure that Kubernetes is cloned in `$(go env GOPATH)/src/k8s.io/kubernetes`\n- build a node image and create a cluster with:\n```console\nkind build node-image\nkind create cluster --image kindest/node:latest\n```\n\nMulti-node clusters and other advanced features may be configured with a config\nfile, for more usage see [the docs][user guide] or run `kind [command] --help`\n\n## Community\n\nPlease reach out for bugs, feature requests, and other issues!\nThe maintainers of this project are reachable via:\n\n- [Kubernetes Slack] in the [#kind] channel\n- [filing an issue] against this repo\n- The Kubernetes [SIG-Testing Mailing List]\n\nCurrent maintainers are [@aojea] and [@BenTheElder] - feel free to\nreach out if you have any questions!\n\nPull Requests are very welcome!\nIf you're planning a new feature, please file an issue to discuss first.\n\nCheck the [issue tracker] for `help wanted` issues if you're unsure where to\nstart, or feel free to reach out to discuss. 🙂\n\nSee also: our own [contributor guide] and the Kubernetes [community page].\n\n## Why kind?\n\n- kind supports multi-node (including HA) clusters\n- kind supports building Kubernetes release builds from source\n  - support for make / bash or docker, in addition to pre-published builds\n- kind supports Linux, macOS and Windows\n- kind is a [CNCF certified conformant Kubernetes installer](https://landscape.cncf.io/?selected=kind)\n\n### Code of conduct\n\nParticipation in the Kubernetes community is governed by the [Kubernetes Code of Conduct].\n\n\u003c!--links--\u003e\n[go]: https://golang.org/\n[go-supported]: https://golang.org/doc/devel/release.html#policy\n[docker]: https://www.docker.com/\n[podman]: https://podman.io/\n[nerdctl]: https://github.com/containerd/nerdctl\n[community page]: https://kubernetes.io/community/\n[Kubernetes Code of Conduct]: code-of-conduct.md\n[Go Report Card Badge]: https://goreportcard.com/badge/sigs.k8s.io/kind\n[Go Report Card]: https://goreportcard.com/report/sigs.k8s.io/kind\n[conformance tests]: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/conformance-tests.md\n[packages]: ./pkg\n[cluster package]: ./pkg/cluster\n[build package]: ./pkg/build\n[kind cli]: ./main.go\n[images]: ./images\n[kubetest]: https://github.com/kubernetes/test-infra/tree/master/kubetest\n[kubeadm]: https://kubernetes.io/docs/reference/setup-tools/kubeadm/kubeadm/\n[design doc]: https://kind.sigs.k8s.io/docs/design/initial\n[user guide]: https://kind.sigs.k8s.io/docs/user/quick-start\n[SIG-Testing Mailing List]: https://groups.google.com/forum/#!forum/kubernetes-sig-testing\n[issue tracker]: https://github.com/kubernetes-sigs/kind/issues\n[filing an issue]: https://github.com/kubernetes-sigs/kind/issues/new\n[Kubernetes Slack]: http://slack.k8s.io/\n[#kind]: https://kubernetes.slack.com/messages/CEKK1KTN2/\n[1.0 roadmap]: https://kind.sigs.k8s.io/docs/contributing/1.0-roadmap\n[install docker]: https://docs.docker.com/install/\n[@BenTheElder]: https://github.com/BenTheElder\n[@munnerz]: https://github.com/munnerz\n[@aojea]: https://github.com/aojea\n[@amwat]: https://github.com/amwat\n[contributor guide]: https://kind.sigs.k8s.io/docs/contributing/getting-started\n[releases]: https://github.com/kubernetes-sigs/kind/releases\n[install guide]: https://kind.sigs.k8s.io/docs/user/quick-start/#installation\n[modules]: https://github.com/golang/go/wiki/Modules\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblock-stacker%2Fkind","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblock-stacker%2Fkind","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblock-stacker%2Fkind/lists"}