Skip to content

Troubleshooting

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

Troubleshooting

Only issues evidenced in the repo's docs, code notes or changelog.

Symptom Cause / fix Source
Container exits immediately Image 0.7.1 or 0.7.2 shipped a stub binary. Use 0.7.3 or later. CHANGELOG 0.7.3
Console missing from the image Images before 0.6.0 had no web console. CHANGELOG 0.6.0
Envoy Gateway never becomes Accepted The eg GatewayClass is not created by the chart; create it. charts/zorvia/README.md
Cannot sign in with default passwords Lab mode is off by default; run scripts/create-auth-secret.sh or set ZORVIA_LAB_MODE=1 for a lab. docs/LAB.md, CHANGELOG 0.4.0
API refuses to start / JWT error outside lab mode ZORVIA_JWT_SECRET must be at least 32 bytes. CHANGELOG 0.4.0
409 VM_RUNNING on revert Stop the VM first, then revert. CHANGELOG 0.5.0
422 SNAPSHOT_REJECTED The cluster rejected the snapshot (e.g. KubeVirt Snapshot feature gate off); the webhook reason is returned. CHANGELOG 0.5.0
Login takes about 1.3 s, bursts are slow bcrypt cost 12 on the default 500m CPU limit; raise the CPU limit. CHANGELOG 0.5.0 known limitations
/api/system/cpu/topology and /numa/topology return 501 Not implemented; Advanced tab hides CPU pinning/NUMA. CHANGELOG 0.5.0
Windows toggle shows "Kryton not reachable" KRYTON_URL unset or unreachable. docs/KRYTON_INTEGRATION.md
VMware import returns 409 Preflight found blockers (missing KubeVirt/CDI, Pod Security level, unknown StorageClass, name taken, no image). docs/VM_IMPORT.md
CDI import crashes with cannot open /dev/cdi-block-volume: Permission denied On Ceph RBD, CDI defaults to Block mode; use volumeMode: Filesystem for the blank DataVolume. tests/e2e/README.md
Live migration test skipped Needs two schedulable nodes. docs/SUPPORT_MATRIX.md
TUI dialog not appearing Terminal at least 80x24. docs/INTERACTIVE_TUI.md

Report bugs at https://github.com/zyvorai/zyvor-zorvia/issues; security issues privately via GitHub Security Advisories (see SECURITY.md).

Clone this wiki locally