Install the evroc CLI

In this guide, you'll install and initialize the evroc CLI to manage your resources from your terminal.

Before you begin

To complete this guide, you'll need an evroc Cloud account for at least one organization.

Warning: If you have the legacy evroc CLI installed, you must uninstall it before installing this version. Both CLIs use the same config.yaml file, and running both will cause configuration conflicts.

Install the latest evroc CLI version

  1. Download one of the following:

    PlatformPre-built binarySHA256 checksum
    macOS 64 bit (amd64)DownloadDownload
    macOS 64 bit (arm64, Apple silicon)DownloadDownload
    Windows 64 bit (amd64)DownloadDownload
    Windows 64 bit (arm64)DownloadDownload
    Linux 64 bit (amd64)DownloadDownload
    Linux 64 bit (arm64)DownloadDownload

  2. Make the binary executable:

    chmod +x evroc

  3. Move the binary to a directory in your PATH.

  4. Verify that the evroc CLI was installed successfully.

    # macOS and Linux
evroc version

# Windows
evroc.exe version

  5. Authenticate the evroc CLI. You'll be redirected to log in via your browser.

    evroc login

    If you belong to more than one organization, you'll need to choose the organization you want to log in to.

The evroc CLI is now ready to use. Try running the following to list all virtual machines:

evroc compute virtualmachine list

Install shell completion for evroc CLI

Run the following command to see shell-specific installation instructions:

evroc completion zsh --help

Replace zsh with your shell. The completion command support the following shells:

  • bash
  • fish
  • powershell
  • zsh

After completing the installation steps, try it out by typing evroc netw in your terminal and then pressing TAB.

Next steps

You can also add --help to any evroc CLI command to get help directly in your terminal.