Skip to main content

Remote deploy

scripts/deploy-remote.sh syncs the repo over SSH, builds/imports the image when needed, and installs the Helm chart. Default lab access is HTTPS NodePort :30899.

Usage​

./scripts/deploy-remote.sh sus@80.79.5.173 --k8s
# → https://HOST:30899
ProfileWhat it does
default / --k3sSync + build + import image + Helm (expects K3s)
--k8sHelm on an existing kubeconfig
--quickSync + Helm only (image already on the host)
--verify-onlycurl healthz on the remote NodePort

Opt-in: --cilium-gateway notes Gateway API enablement (NodePort remains the default path).

Auth​

SSH keys / ssh-agent. Non-root users need passwordless sudo for k3s kubeconfig mirror and container image import. Set KAVACH_TOKEN (or chart auth.token / auth.existingSecret) before install — minimum 8 characters (lab default Admin@321).

After deploy​

export KAVACH_TOKEN="${KAVACH_TOKEN:-Admin@321}"
curl -k -H "Authorization: Bearer $KAVACH_TOKEN" https://HOST:30899/v1/summary

# Envoy Gateway (if --envoy-gateway):
# https://kavach.HOST.sslip.io:30943/

Console​

  1. Open https://HOST:30899/ or the Envoy URL.
  2. Sign in with username admin and password Admin@321 (must match the chart token).
  3. Prefer kavachctl status --wait for a CLI health board.

See tutorial.md, console.md, envoy-gateway.md.

Remote checkout defaults to ~/.deployments/kavach (KAVACH_REMOTE_SUBDIR overrides).