This is unreleased documentation for Admission Controller 1.30-next.

Installing kwctl

kwctl is the command-line interface (CLI) tool for SUSE Security Admission Controller. Below are installation instructions for some operating systems.

  • Linux

  • macOS

  • Windows

Install for Linux

  1. Homebrew

    If you use the Homebrew package manager on Linux, then:

    brew install kwctl

    Verify installation:

    kwctl --version

  2. Zypper (openSUSE)

    zypper install kwctl

  3. AUR

    If you’re using Arch Linux, or an Arch-based distribution, you can install kwctl from the AUR.

    1. Using an AUR helper (yay):

      yay -S kwctl

    2. Using makepkg:

      # Clone the AUR package
git clone https://aur.archlinux.org/kwctl.git
cd kwctl

# Build and install the package
makepkg -si

    3. Verify the installation:

      kwctl --version

  4. Manual installation

    1. Download the latest release of kwctl for Linux:

      curl -LO https://github.com/kubewarden/kwctl/releases/latest/download/kwctl-linux-x86_64.zip

      For ARM64 systems (e.g., Raspberry Pi), use:

      curl -LO https://github.com/kubewarden/kwctl/releases/latest/download/kwctl-linux-aarch64.zip

    2. Extract the files from the downloaded .zip file:

      unzip kwctl-linux-x86_64.zip

      This extracts the following files:

      • kwctl-linux-x86_64: The kwctl binary

      • kwctl-linux-x86_64.sig: A signature file for verifying the binary

      • kwctl-linux-x86_64.pem: A certificate file for verifying the signature

    3. Move the binary to a directory in your PATH, rename to kwctl and make executable.

    4. Verify the installation:

      kwctl --version

Install for macOS.

  1. Using Homebrew

    1. Install kwctl:

      brew install kwctl

      Verify installation:

      kwctl --version

  2. Manual installation

    1. Download the latest release of kwctl for macOS:

      1. For Apple Silicon (ARM64) systems, use:

        curl -LO https://github.com/kubewarden/kwctl/releases/latest/download/kwctl-darwin-aarch64.zip

      2. For Intel (x86_64) systems, use:

        curl -LO https://github.com/kubewarden/kwctl/releases/latest/download/kwctl-darwin-x86_64.zip

      3. Extract the files from the downloaded .zip file:

        unzip kwctl-darwin-x86_64.zip

        This extracts the following files:

        • kwctl-darwin-x86_64: The kwctl binary

        • kwctl-darwin-x86_64.sig: A signature file for verifying the binary

        • kwctl-darwin-x86_64.pem: A certificate file for verifying the signature

    2. Move the binary to a directory in your PATH, rename to kwctl and make executable.

    3. Verify the installation:

      kwctl --version

Install for Windows

  1. Download kwctl:

    1. Open your browser and go to the Admission Controller releases page.

    2. Download the kwctl-windows-x86_64.zip file.

  2. Extract the files from the downloaded zip file. It will contain:

    • kwctl-windows-x86_64.exe: the kwctl binary.

    • kwctl-windows-x86_64.sig: a signature file for verifying the binary.

    • kwctl-windows-x86_64.pem: a certificate file for verifying the signature.

  3. Rename the binary file from kwctl-windows-x86_64.exe to kwctl.exe for easier use.

  4. Move the binary to a location covered by your PATH environment variable.

  5. Verify the installation. Open a new command prompt or PowerShell window and check the kwctl installation:

    kwctl --version

Install shell completions

The kwctl CLI has the --shell option to generate shell completion commands for your shell. You can use the output from this command to integrate completions into your shell.

kwctl completions --shell [bash|elvish|fish|powershell|zsh]