# Install k0sctl with Homebrew, apk, MacPorts, Nix, zypper, winget Bootstrapping and management tool for k0s clusters. Version 0.32.1 via Homebrew; verified 2026-07-06. Also installable with nix: nix profile install nixpkgs#k0sctl. ## Install ```sh sudo av install brew:k0sctl ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install k0sctl ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install k0sctl ``` Evidence: MacPorts ports tree: sysutils/k0sctl/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add k0sctl ``` Evidence: Alpine Linux edge package indexes: k0sctl from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - Nix (92%): ```sh nix profile install nixpkgs#k0sctl ``` Evidence: nixpkgs package indexes: pkgs/by-name/k0/k0sctl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - zypper (92%): ```sh sudo zypper install k0sctl ``` Evidence: openSUSE Tumbleweed package metadata: k0sctl from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ### Windows - winget (92%): ```sh winget install --id k0sproject.k0sctl -e ``` Evidence: Windows Package Manager source index: k0sproject.k0sctl from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:k0sctl - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.32.1 - **Source summary:** Bootstrapping and management tool for k0s clusters - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-07-06T14:02:59Z - **Generated:** 2026-07-26T07:20:29+00:00 ## Executables - k0sctl (cli) - k0sctl (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-26 - Package-manager version: 0.32.1 - Package-manager updated: 2026-07-06 - Local data: ok - Upstream repository: https://github.com/k0sproject/k0sctl - Upstream latest detected: v0.32.1 (current) ## Project history and usage k0sctl is the companion command-line bootstrap and lifecycle tool for k0s Kubernetes clusters, using SSH and a YAML cluster definition to configure hosts and deploy k0s. ### Project history k0sctl appeared with the k0s project after k0s began public releases in November 2020. Its early 2021 releases established the `k0sctl apply` workflow: describe hosts and desired cluster state in `k0sctl.yaml`, then let the tool connect over SSH and converge the cluster. The k0s documentation positioned k0sctl as an automatic and repeatable way to create multi-node and production clusters, making it part of the official installation story rather than a third-party convenience script. ### Adoption history Adoption follows k0s adoption: users who want a small Kubernetes distribution but do not want to hand-roll SSH loops, install commands, token exchange, and kubeconfig retrieval can use k0sctl as the repeatable wrapper. ### How it is used The main workflow is `k0sctl apply`, pointed at a `k0sctl.yaml` file in the working directory or another path passed with `--config`. The tool gathers host state through SSH, installs k0s, joins nodes, and can generate kubeconfig output. ### Why package nerds care k0sctl is a good example of a package-manager-friendly infrastructure binary: one statically distributed CLI, a declarative local YAML file, no daemon, and behavior that turns a cluster installation process into a repeatable command. ### Timeline - 2020: k0s made its initial public release in November. - 2021: k0sctl v0.4.0 was published in February. - 2021: k0s documentation for v1.21.0+k0s.0 recommended k0sctl for production cluster installation and automatic upgrades. ### Related projects - k0sctl is tightly coupled to k0s, and sits in the same broad Kubernetes bootstrap space as k3sup, kubeadm wrappers, and other SSH-driven cluster installers. ### Sources - - - - - ## Security Notes No matching local secret-handling manifest was found for k0sctl. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: k0sctl.yaml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** k0sctl - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - k0sctl: normalized package name match | nixpkgs package indexes: pkgs/by-name/k0/k0sctl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - apk - k0sctl - 0.30.1-r0: normalized package name match | Alpine Linux edge package indexes: k0sctl from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bootstrapping and management tool for k0s clusters | https://github.com/k0sproject/k0sctl - apk - k0sctl-bash-completion - 0.30.1-r0: normalized package name match | Alpine Linux edge package indexes: k0sctl-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for k0sctl | https://github.com/k0sproject/k0sctl - apk - k0sctl-fish-completion - 0.30.1-r0: normalized package name match | Alpine Linux edge package indexes: k0sctl-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Fish completions for k0sctl | https://github.com/k0sproject/k0sctl - apk - k0sctl-zsh-completion - 0.30.1-r0: normalized package name match | Alpine Linux edge package indexes: k0sctl-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Zsh completions for k0sctl | https://github.com/k0sproject/k0sctl - zypper - k0sctl - 0.30.1-1.1: normalized package name match | openSUSE Tumbleweed package metadata: k0sctl from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | A bootstrapping and management tool for k0s clusters | https://github.com/k0sproject/k0sctl - zypper - k0sctl-bash-completion - 0.30.1-1.1: normalized package name match | openSUSE Tumbleweed package metadata: k0sctl-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Bash Completion for k0sctl | https://github.com/k0sproject/k0sctl - zypper - k0sctl-fish-completion - 0.30.1-1.1: normalized package name match | openSUSE Tumbleweed package metadata: k0sctl-fish-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Fish Completion for k0sctl | https://github.com/k0sproject/k0sctl - zypper - k0sctl-zsh-completion - 0.30.1-1.1: normalized package name match | openSUSE Tumbleweed package metadata: k0sctl-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Zsh Completion for k0sctl | https://github.com/k0sproject/k0sctl - MacPorts - k0sctl: normalized package name match | MacPorts ports tree: sysutils/k0sctl/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - winget - k0sproject.k0sctl: normalized package name match | Windows Package Manager source index: k0sproject.k0sctl from https://cdn.winget.microsoft.com/cache/source.msix ## Related links - [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family. - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [k3sup](https://www.automicvault.com/pkg/brew/k3sup/) - Shares av.db curated category or tags: bootstrap, cli, cloud-infrastructure, kubernetes, ssh. - [clusterctl](https://www.automicvault.com/pkg/brew/clusterctl/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes. - [cmctl](https://www.automicvault.com/pkg/brew/cmctl/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes. - [k9s](https://www.automicvault.com/pkg/brew/k9s/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes. - [kops](https://www.automicvault.com/pkg/brew/kops/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes. - [kty](https://www.automicvault.com/pkg/brew/kty/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes, ssh. - [kubernetes-cli](https://www.automicvault.com/pkg/brew/kubernetes-cli/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes. - [ocm](https://www.automicvault.com/pkg/brew/ocm/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes. - [osdctl](https://www.automicvault.com/pkg/brew/osdctl/) - Local package facts share a topical domain. Shared terms: cli, cloud, cloud-infrastructure, cluster, cluster-management. - [rancher-cli](https://www.automicvault.com/pkg/brew/rancher-cli/) - Local package facts share a topical domain. Shared terms: cli, cloud, cloud-infrastructure, cluster, cluster-management. - [flintrock](https://www.automicvault.com/pkg/brew/flintrock/) - Local package facts share a topical domain. Shared terms: cli, cloud, cloud-infrastructure, cluster, cluster-management. ## Combined YAML source View the package source record on GitHub. [combined/k0sctl.yml](https://github.com/automic-vault/db/blob/main/combined/k0sctl.yml) ## Sources - Nucleus package database - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph