The fastest way to get KubeOne is to use our installation script:
curl -sfL https://get.kubeone.io | sh
The installation script downloads the release archive from GitHub, installs
the KubeOne binary in your /usr/local/bin
directory and unpacks the example
Terraform configs in your current working directory. If you want to inspect the
script before running it, you can use a command such as
curl -sfL https://get.kubeone.io | less
or check it on GitHub.
You can download the binary from the GitHub Releases.
Find the archive for your operating system and architecture, and download it
or grab the URL and use it with wget
or curl
.
Version: version of KubeOne
Operating system: linux
or darwin
for macOS
curl -LO https://github.com/kubermatic/kubeone/releases/download/v<version>/kubeone_<version>_<operating_system>_amd64.zip
Extract the archive. On Linux and macOS, you can use unzip
.
unzip kubeone_<version>_<operating_system>_amd64.zip -d kubeone_<version>_<operating_system>_amd64
Move the kubeone
binary to your $PATH
, so you can easily invoke it from
your terminal.
sudo mv kubeone_<version>_<operating_system>_amd64/kubeone /usr/local/bin
For a quick way to install the latest version of KubeOne, use the following commands:
OS=$(uname)
VERSION=$(curl -w '%{url_effective}' -I -L -s -S https://github.com/kubermatic/kubeone/releases/latest -o /dev/null | sed -e 's|.*/v||')
curl -LO "https://github.com/kubermatic/kubeone/releases/download/v${VERSION}/kubeone_${VERSION}_${OS}_amd64.zip"
unzip kubeone_${VERSION}_${OS}_amd64.zip -d kubeone_${VERSION}_${OS}_amd64
sudo mv kubeone_${VERSION}_${OS}_amd64/kubeone /usr/local/bin
KubeOne can be found in the official Arch Linux repositories.
Use pacman
or your preferred package manager to install it.
pacman -S kubeone
If you have the Go toolchain configured, you can use go install
to obtain KubeOne.
To get the latest stable release:
go install k8c.io/kubeone@latest
To get a specific release, you can replace latest
with the tag that you
want to use. Check out the GitHub Releases for the list of
available tags.
go install k8c.io/kubeone@<tag>
To get the development version (the main
branch), you can use the following
command:
go install k8c.io/kubeone@main
If you already have KubeOne repository cloned, you can use make
to install it.s
make
While running of the main branch is a great way to peak at and test the new features before they are released, note that main branch can break at any time or may contain bugs. Official releases are considered stable and recommended for the production usage.
KubeOne comes with commands for generating scripts for the shell completion and for the documentation in format of man pages and more.
To active completion for your current session, run the following command.
source <(kubeone completion bash)
To active completion permanently, add the command to your ~/.bashrc
file.
echo "source <(kubeone completion bash)" >> ~/.bashrc
To active completion for your current session, run the following command.
source <(kubeone completion zsh)
To active completion permanently, add the command to your ~/.zshrc
file.
echo "source <(kubeone completion zsh)" >> ~/.zshrc
To generate documentation (man pages for example, more available), run:
kubeone document man -o /tmp/man