FAQ

FAQ

Short answers. Full FAQ: docs/user-guides/faq.md.

Does GuestKit use libguestfs?

No. Pure Rust parsers + host NBD/loop mount. Do not install libguestfs-tools expecting GuestKit to call them.

How does it compare to virt-v2v / MTV?

Different jobs. GuestKit inspects, scores, plans, repairs offline, and emits a Passport. MTV/virt-v2v convert/orchestrate. Use Passport as the gate before convert.

What host packages do I need?

Linux with qemu-img, losetup, and qemu-nbd. Mount and repair often need root.

Why does mount fail on my laptop?

RAW/IMG often use loop; QCOW2/VMDK use NBD. Add --trace to see the path. Ensure qemu-nbd / NBD module is available and you have privileges.

Windows password reset offline?

guestkit rescue win.qcow2 -o reset-password --user … --password …
AES/RC4 SAM NT-hash write needs a build with --features registry-write (libhivex). Otherwise SAM blank + RunOnce net user.

PackageInstall with no dnf/apt on the host?

Set GUESTKIT_PACKAGE_CACHE with pre-downloaded packages, and/or GUESTKIT_PACKAGE_FETCH=1 plus GUESTKIT_PACKAGE_MIRROR for HTTP curl/wget fallback. See Offline Packages and Services.

Is the GHCR eval stack safe to expose?

No. deploy/docker-compose.ghcr.yml is unauthenticated eval. Use production compose / Helm and change default console credentials before any network exposure. See DOCKER.md.

Where is the full feature map?

Customer Feature Guide · Docs Index