Installation

Supported platforms

Avocado CLI ships prebuilt binaries for the following OS / architecture combinations on every release:

Operating system	Architecture	Target triple
macOS	Apple Silicon	aarch64-apple-darwin
macOS	Intel	x86_64-apple-darwin
Linux	aarch64 (static)	aarch64-unknown-linux-musl
Linux	x86_64 (glibc)	x86_64-unknown-linux-gnu
Linux	x86_64 (static)	x86_64-unknown-linux-musl
Windows	x86_64	x86_64-pc-windows-msvc

The Linux *-musl builds are statically linked, so they do not depend on the host glibc version, but they still require a compatible Linux kernel and matching architecture. The *-gnu build is dynamically linked against glibc and is suitable for mainstream Linux distributions with glibc 2.31 or newer (Debian 11+, Ubuntu 20.04+, Fedora 33+, RHEL 9+).

The install script picks the appropriate binary automatically. For manual installs, download the matching artifact from the releases page.

Install

On macOS or Linux:

curl -fsSL https://connect.peridio.com/install.sh | sh

On Windows, or to install manually, use the GitHub releases:

1. Download an Avocado CLI tarball from the releases page.
2. Extract the tarball using the following command:

   tar -xzvf <tarball>

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

   mv avocado /usr/local/bin/

4. Verify the installation:

   avocado --version

   If successful, you should see the version number displayed.

Upgrade

To upgrade to the latest version:

avocado upgrade

To upgrade to a specific version:

avocado upgrade --version <version>