CLI
Installation

CLI Installation

The Onvera CLI is distributed as pre-built binaries hosted on S3 at https://onvera-downloads.s3.amazonaws.com/cli.

Linux / macOS

Install using the installation script:

curl -fsSL https://onvera-downloads.s3.amazonaws.com/cli/install/install.sh | sh

The installer automatically:

  • Detects your architecture (amd64 or arm64)
  • Downloads the appropriate binary
  • Verifies the checksum
  • Installs to /usr/local/bin or ~/.local/bin

Verify installation:

onvera version

Manual Installation

If you prefer manual installation:

  1. Download the binary:
# For Linux AMD64
curl -L https://onvera-downloads.s3.amazonaws.com/cli/latest/onvera-linux-amd64 -o onvera
 
# For Linux ARM64
curl -L https://onvera-downloads.s3.amazonaws.com/cli/latest/onvera-linux-arm64 -o onvera
 
# For macOS AMD64
curl -L https://onvera-downloads.s3.amazonaws.com/cli/latest/onvera-darwin-amd64 -o onvera
 
# For macOS ARM64 (Apple Silicon)
curl -L https://onvera-downloads.s3.amazonaws.com/cli/latest/onvera-darwin-arm64 -o onvera
  1. Make it executable:
chmod +x onvera
  1. Move to PATH:
# System-wide (requires sudo)
sudo mv onvera /usr/local/bin/
 
# Or user-local
mkdir -p ~/.local/bin
mv onvera ~/.local/bin/
export PATH="$HOME/.local/bin:$PATH"

Windows

PowerShell

iwr -useb https://onvera-downloads.s3.amazonaws.com/cli/install/install.ps1 | iex

Manual Installation

  1. Download the Windows binary:
Invoke-WebRequest -Uri https://onvera-downloads.s3.amazonaws.com/cli/latest/onvera-windows-amd64.exe -OutFile onvera.exe
  1. Add to PATH or move to a directory in your PATH.

Version Pinning

Install a specific version:

ONVERA_CLI_VERSION=v0.0.1 curl -fsSL https://onvera-downloads.s3.amazonaws.com/cli/install/install.sh | sh

Troubleshooting

Binary not found after installation

If onvera is not found after installation:

  1. Check installation location:
# System-wide
ls -l /usr/local/bin/onvera
 
# User-local
ls -l ~/.local/bin/onvera
  1. Add to PATH:

Add this to your ~/.bashrc or ~/.zshrc:

export PATH="$HOME/.local/bin:$PATH"

Then reload:

source ~/.bashrc  # or source ~/.zshrc

Checksum verification fails

If checksum verification fails:

  • Ensure you have sha256sum or shasum installed
  • Try downloading again (may be a network issue)
  • Check that you're using the correct architecture binary

Permission denied

If you get permission errors:

  • Use sudo for system-wide installation
  • Or install to ~/.local/bin (user-local, no sudo required)

Next Steps

After installation:

  1. Authenticate - Log in to your Onvera account
  2. Deploy your first app - Get started with a deployment
OverviewAuthentication