Links
Comment on page

Installing the ZLI

BastionZero's command line interface for connecting to your targets
BastionZero's command-line interface (CLI), the Zero-Trust Command Line Interface (zli), is available on Mac, Linux, and Windows machines.
You can download the zli through package managers (brew, yum, and apt), through GitHub for Linux and Mac distributions, or with curl for Windows machines.
The zli is compatible with both x86 and amd64 platforms.
Brew
Yum
Apt
GitHub
Windows
  1. 1.
    Install the zli.
    brew install bastionzero/tap/zli
  1. 1.
    Use the yum-config-manager to add the BastionZero repo.
    sudo yum-config-manager --add-repo \
    https://download-yum.bastionzero.com/bastionzero.repo
  2. 2.
    Install the zli.
    sudo yum install -y zli
  1. 1.
    Install the BastionZero public key from the Ubuntu key-server.
    sudo apt-key adv --keyserver keyserver.ubuntu.com\
    --recv-keys E5C358E613982017
  2. 2.
    For http (i.e., on an Ubuntu 14.x machine), add the BastionZero repo with:
    sudo add-apt-repository \
    'deb http://download-apt.bastionzero.com/production/apt-repo stable main'
  3. 3.
    For https, add the BastionZero repo with:
    sudo add-apt-repository \
    'deb https://download-apt.bastionzero.com/production/apt-repo stable main'
  4. 4.
    Update the apt cache.
    sudo apt update
  5. 5.
    Install the zli.
    sudo apt install -y zli
  1. 1.
    Navigate to the zli repository's installing a release page.
  2. 2.
    Choose the MacOS or Linux distribution needed and download the executable.
  3. 3.
    For Mac users,
    • chmod +x the executable.
    • Run the program once and see a warning from Apple.
    • Go to System Preferences > Security & Privacy > General > Allow zli.
    • Run the executable again and confirm with Apple.
  4. 4.
    For Linux users,
    • chmod +x the executable.
Minor releases generate warnings for users to update their zli. Major releases will cause all lower major versions to error.
  1. 1.
    Download the zli.
    curl.exe -LO "https://download-zli.bastionzero.com/release/latest/bin/zli.exe"
  2. 2.
    Append the zli binary folder to your PATH environment variable. Note, the following example will make the zli commands permanently available to the current user only.
    setx PATH "%PATH%;<path to folder containing zli>"
  3. 3.
    Exit out of your terminal window and reopen a new one.
  4. 4.
    Log in to the zli.
    zli login
Have feedback on the docs? Please reach out to [email protected].
Copyright © 2023