/cli

Primary LanguageRustApache License 2.0Apache-2.0

Rivet CLI

Installation

macOS & Linux & WSL

Install latest version

curl -fsSL https://raw.githubusercontent.com/rivet-gg/cli/main/install/unix.sh | sh

Install specific version

We recommend specifying the CLI version in CI environments. This also allows you to install prerelease versions of the CLI.

export RIVET_CLI_VERSION="v1.0.0"
curl -fsSL https://raw.githubusercontent.com/rivet-gg/cli/${RIVET_CLI_VERSION}/install/unix.sh | sh

The export keyword is important. The variable RIVET_CLI_VERSION needs to be accessible inside the install script.

Windows (cmd)

Install latest version

powershell -Command "iwr https://raw.githubusercontent.com/rivet-gg/cli/main/install/windows.ps1 -useb | iex"

Install specific version

We recommend specifying the CLI version in CI environments. This also allows you to install prerelease versions of the CLI.

powershell -Command "$env:RIVET_CLI_VERSION='v1.0.0'; iwr https://raw.githubusercontent.com/rivet-gg/cli/$env:RIVET_CLI_VERSION/install/windows.ps1 -useb | iex"
Windows (PowerShell)

Install latest version

iwr https://raw.githubusercontent.com/rivet-gg/cli/main/install/windows.ps1 -useb | iex

Install specific version

We recommend specifying the CLI version in CI environments. This also allows you to install prerelease versions of the CLI.

$env:RIVET_CLI_VERSION='v1.0.0'
iwr https://raw.githubusercontent.com/rivet-gg/cli/$env:RIVET_CLI_VERSION/install/windows.ps1 -useb | iex
Build from source (cargo install)
cargo install --git=https://github.com/rivet-gg/cli

Important This will install the CLI as rivet-cli (not rivet).

Important Ensure you have OpenSSL installed and configured correctly.

Build from source (cargo build)
git clone https://github.com/rivet-gg/cli
cd cli
cargo build

The executable will be available at target/debug/rivet-cli.

Important Ensure you have OpenSSL installed and configured correctly.

Documentation

All commands in the Rivet CLI are documented with the --help flag.

$ rivet --help

USAGE:
    rivet [OPTIONS] <SUBCOMMAND>

OPTIONS:
        --api-url <API_URL>            [env: RIVET_CLOUD_API_URL=]
        --token <CLOUD_TOKEN>    [env: RIVET_TOKEN=]
    -h, --help                         Print help information
    -V, --version                      Print version information

SUBCOMMANDS:
    dashboard    Opens the dashboard for this game
    deploy       Alias of `rivet version deploy`
    engine       Run engine-specific commands
    game         Manages the game
    help         Print this message or the help of the given subcommand(s)
    image        Manages builds for Serverless Lobbies
    init         Guided setup for this project
    namespace    Manages namespaces
    site         Manages sites for the CDN
    token        Manages tokens
    version      Manages versions