Repository navigation
Troubleshooting
Susant Sahani edited this page Oct 18, 2026
·
1 revision
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).
Zorvia is Apache-2.0. Repo: https://github.com/zyvorai/zyvor-zorvia. This wiki summarizes the repo docs and may lag them; the repo wins.