Server Setup

Install the Trellis CLI

Install the trellis command-line tool from a GitHub release or build it with Cargo.

The trellis CLI handles contract verification, SDK generation, service installation, upgrades, and authentication. Install it before following any of the other guides.

Option A: Download a prebuilt binary

Prebuilt binaries are published as GitHub Releases for every tagged version.

Pick the archive that matches your platform:

PlatformArchive
Linux x86_64trellis-<version>-x86_64-unknown-linux-gnu.tar.gz
Linux aarch64trellis-<version>-aarch64-unknown-linux-gnu.tar.gz
macOS Inteltrellis-<version>-x86_64-apple-darwin.tar.gz
macOS Apple Silicontrellis-<version>-aarch64-apple-darwin.tar.gz

Download and extract:

curl -LO https://github.com/qlever-llc/trellis/releases/latest/download/trellis-<version>-<target>.tar.gz
tar xzf trellis-*.tar.gz

Move the binary somewhere on your PATH:

install -m 755 trellis ~/.local/bin/trellis

Each release also includes a .sha256 checksum file you can verify with sha256sum -c.

Option B: Install with Cargo

If you have a Rust toolchain installed:

cargo install trellis-cli

This builds from source and places the trellis binary in your Cargo bin directory (usually ~/.cargo/bin).

Verify

trellis --version