Bootstrap Command

The bootstrap command creates a single node cluster using the current node as the master.

All Available Commands and Flags

pf9ctl bootstrap --help

Bootstrap a single node Kubernetes cluster with current node as the master node.

Usage:

pf9ctl bootstrap [flags] cluster-name

Examples:

pf9ctl bootstrap <clusterName> --pmk-version <version>

Required Flags:

--pmk-version string Kubernetes pmk version

Optional Flags:

--advanced-api-configuration string Allowed API groups and version. Option: default, all & custom

--allow-workloads-on-master Taint master nodes ( to enable workloads ), use either --allow-workloads-on-master or --allow-workloads-on-master=false to change (default true)

--api-server-flags strings Comma separated list of supported kube-apiserver flags, e.g: --request-timeout=2m0s,--kubelet-timeout=20s

--block-size string Block size determines how many Pod's can run per node vs total number of nodes per cluster (default "26")

--container-runtime string The container runtime for the cluster (default "containerd")

The bootstrap command requires a cluster name to complete successfully. During the bootstrap process the CLI will prompt the user asking if the node should be set up as a Master node, in most circumstances answer yes

#pf9ctl bootstrap trial --pmk-version 1.21.3-pmk.111

✓ Loaded Config Successfully

✓ Node is not onboarded and not attached to any cluster

✓ Removal of existing CLI

✓ Existing Platform9 Packages Check

✓ Required OS Packages Check

✓ SudoCheck

✓ CPUCheck

✓ DiskCheck

✓ MemoryCheck - At least 12 GB of memory is needed on host. Total memory found: 4 GB

✓ PortCheck

✓ Existing Kubernetes Cluster Check

✓ Check lock on dpkg

✓ Check lock on apt

✓ Check if system is booted with systemd

✓ Check time synchronization

✓ Check if firewalld service is not running

✓ Disabling swap and removing swap in fstab

✓ Completed Pre-Requisite Checks successfully

Optional pre-requisite check(s) failed. See /home/ubuntu/pf9/log/pf9ctl-20211119.log or use --verbose for logs

Prep local node as master node for kubernetes cluster (y/n): y

Last updated on Jan 23, 2026

Was this page helpful?

Bootstrap Command

Syntax Example

All Available Commands and Flags

Command Example