Skip to content

Install

Susant Sahani edited this page Oct 18, 2026 · 1 revision

Install

Requirements (from the README): Rust 1.89+, a kubeconfig, and a cluster with KubeVirt. CDI is optional (golden images, CDI clone).

Build the CLI

git clone https://github.com/zyvorai/zyvor-zorvia.git && cd zyvor-zorvia
cargo install --path . --features web   # `web` is the default feature
# or: cargo build --release --features web  ->  target/release/zorvia

Install into a cluster with Helm

helm upgrade --install zorvia charts/zorvia -n zorvia-system --create-namespace \
  -f charts/zorvia/values-lab.yaml

The chart ships values files values-lab.yaml, values-production.yaml and values-ha.yaml (two replicas with PostgreSQL, Beta).

Production notes from charts/zorvia/README.md:

  • Create unique credentials first with ./scripts/create-auth-secret.sh and do not set ZORVIA_LAB_MODE; pass --set auth.existingSecret=zorvia-auth.
  • Production values expose Zorvia through Envoy Gateway (Gateway API HTTPRoute + Gateway, class eg). The chart does not create the eg GatewayClass; without it the Gateway never becomes Accepted.
  • Set httpRoute.hostnames[0], and image repository ghcr.io/zyvorai/zorvia with the tag you want.

One command to a running console

From a checkout, with SSH and passwordless sudo on a Linux host:

# fresh host: installs k3s + Cilium + KubeVirt + CDI + Envoy Gateway, then Zorvia
./deploy/remote-deploy.sh <host> <user> --bootstrap --image
# host with KubeVirt already: deploy the published image
./deploy/remote-deploy.sh <host> <user> --image
./deploy/remote-deploy.sh <host> <user> --image=ghcr.io/zyvorai/zorvia:0.6.0   # pin a release

Per the README, nothing is compiled on the host, the script prints the console URL (https://<host>:30152) and the generated admin password once, and exits non-zero unless /api/v1/health returns 200.

Image

ghcr.io/zyvorai/zorvia. Use 0.7.3 or later: per the changelog, the 0.7.1 and 0.7.2 images are unusable (stub binary). Release binaries are Linux only; macOS and linux-arm64 binaries are not built.

Not verified here

I did not run any of these install paths while writing this wiki. See docs/getting-started.md and docs/LAB.md.

Clone this wiki locally