Skip to main content

Getting Started

Welcome to the Zarf documentation! This section will list the various ways to install Zarf onto your machine. It will also demonstrate how to verify the installation. Choose the installation type that best suits your needs in accordance with your operating system. Let’s get started.

Installing Zarf

There are multiple ways to get the Zarf CLI onto your machine:

Installing from the Defense Unicorns Homebrew Tap

Homebrew is an open-source software package manager that simplifies the installation of software on macOS and Linux. With Homebrew, installing Zarf is simple:

brew tap defenseunicorns/tap
brew install zarf

The above command detects your OS and system architecture and installs the correct Zarf CLI binary for your machine. Once the above command is entered, the CLI should be installed on your $PATH and ready for immediate use.

Downloading a Prebuilt Binary from our GitHub Releases

All Zarf releases on GitHub include prebuilt binaries that you can download and use. We offer a small range of combinations of OS and architecture for you to choose from. Once downloaded, you can install the binary onto your $PATH by moving the binary to the /usr/local/bin directory:

mv ./path/to/downloaded/{ZARF_FILE} /usr/local/bin/zarf

Building the CLI from Scratch

If you want to build the CLI from scratch, you can do that too. Our local builds depend on Go 1.19.x and are built using make.

note

The make build-cli` command builds a binary for each combination of OS and architecture. If you want to shorten the build time, you can use an alternative command to only build the binary you need:

  • make build-cli-mac-intel
  • make build-cli-mac-apple
  • make build-cli-linux-amd
  • make build-cli-linux-arm

For additional information, see the Building Your Own Zarf CLI page.


Verifying Zarf Install

Now that you have installed Zarf, let's verify that it is working. First, we'll check the version of Zarf that has been installed:

$ zarf version

vX.X.X # X.X.X is replaced with the version number of your specific installation

If you are not seeing this then Zarf was not installed onto your $PATH correctly. This $PATH guide should help with that.


Where to Next?

Depending on how familiar you are with Kubernetes, DevOps, and Zarf, let's find what set of information would be most useful to you.

  • If you want to become more familiar with Zarf and it's features, see the Walkthroughs page.

  • More information about the Zarf CLI is available on the Zarf CLI page, or by browsing through the help descriptions of all the commands available through zarf --help.

  • More information about the packages that Zarf creates and deploys is available in the Understanding Zarf Packages page.

  • If you want to take a step back and better understand the problem Zarf is trying to solve, you can find more context on the Understand the Basics and Core Concepts pages.