Skip to main content

Initializing a K8s Cluster


In this tutorial, we will demonstrate how to initialize Zarf onto a K8s cluster. This is done by running the zarf init command, which uses a specialized package called an 'init-package'. More information about this specific package can be found here.


Before beginning this tutorial you will need the following:

Initializing the Cluster

  1. Run the zarf init command on your cluster.
$ zarf init
  1. When prompted to deploy the package select y for Yes, then hit the enter key.

  2. Decline Optional Components


More information about the init-package and its components can be found here


You will only be prompted to deploy the k3s component if you are on a Linux machine

Validating the Deployment

After the zarf init command is done running, you should see a few new zarf pods in the Kubernetes cluster.

zarf tools monitor

# Note you can press `0` if you want to see all namespaces and CTRL-C to exit

Zarf Tools Monitor

Cleaning Up

The zarf destroy command will remove all of the resources that were created by the initialization command. This command will leave you with a clean cluster that you can either destroy or use for another tutorial.

zarf destroy --confirm