---
name: "kubeadm"
section: "1"
platform: "linux"
package: "kubeadm"
version: "1.37.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/kubeadm"
---

# kubeadm(1)

kubeadm: easily bootstrap a secure Kubernetes cluster

Eric Paris Jan 2015

## NAME

kubeadm - kubeadm: easily bootstrap a secure Kubernetes cluster

## SYNOPSIS

**kubeadm** \[OPTIONS\]

## DESCRIPTION

```
┌──────────────────────────────────────────────────────────┐
│ KUBEADM                                                  │
│ Easily bootstrap a secure Kubernetes cluster             │
│                                                          │
│ Please give us feedback at:                              │
│ https://github.com/kubernetes/kubeadm/issues             │
└──────────────────────────────────────────────────────────┘
```

Example usage:

```
Create a two-machine cluster with one control-plane node
(which controls the cluster), and one worker node
(where your workloads, like Pods and Deployments run).
┌──────────────────────────────────────────────────────────┐
│ On the first machine:                                    │
├──────────────────────────────────────────────────────────┤
│ control-plane# kubeadm init                              │
└──────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────┐
│ On the second machine:                                   │
├──────────────────────────────────────────────────────────┤
│ worker# kubeadm join <arguments-returned-from-init>      │
└──────────────────────────────────────────────────────────┘
You can then repeat the second step on as many other machines as you like.
```

## OPTIONS

**--rootfs**=""\
 	The path to the 'real' host root filesystem. This will cause kubeadm to chroot into the provided path.

**--version**=false\
 	\--version, --version=raw prints version information and quits; --version=vX.Y.Z... sets the reported version

## SEE ALSO

**[kubeadm-alpha(1)](/kubeadm-alpha/1.md)**, **[kubeadm-certs(1)](/kubeadm-certs/1.md)**, **[kubeadm-completion(1)](/kubeadm-completion/1.md)**, **[kubeadm-config(1)](/kubeadm-config/1.md)**, **[kubeadm-init(1)](/kubeadm-init/1.md)**, **[kubeadm-join(1)](/kubeadm-join/1.md)**, **[kubeadm-kubeconfig(1)](/kubeadm-kubeconfig/1.md)**, **[kubeadm-reset(1)](/kubeadm-reset/1.md)**, **[kubeadm-token(1)](/kubeadm-token/1.md)**, **[kubeadm-upgrade(1)](/kubeadm-upgrade/1.md)**, **[kubeadm-version(1)](/kubeadm-version/1.md)**,

## HISTORY

January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since!