{"id":22536,"library":"virtme-ng","title":"virtme-ng","description":"Build and run a kernel inside a virtualized snapshot of your live system. Current version: 1.41. Released approximately weekly.","status":"active","version":"1.41","language":"python","source_language":"en","source_url":"https://github.com/arighi/virtme-ng","tags":["kernel","virtualization","testing"],"install":[{"cmd":"pip install virtme-ng","lang":"bash","label":"pip install"},{"cmd":"pip install virtme-ng[full]","lang":"bash","label":"pip install with full dependencies"}],"dependencies":[],"imports":[{"note":"VirtmeNGConfig is in virtme_ng.run, not top-level.","wrong":"from virtme_ng import VirtmeNGConfig","symbol":"VirtmeNGConfig","correct":"from virtme_ng.run import VirtmeNGConfig"}],"quickstart":{"code":"from virtme_ng.run import VirtmeNGConfig, VirtmeNGRunner\n\nconfig = VirtmeNGConfig(kernel_path='/path/to/bzImage', rootfs='/path/to/rootfs', memory='512M', cpus=2)\nrunner = VirtmeNGRunner(config)\nrunner.run()","lang":"python","description":"Run a kernel inside a virtualized snapshot of your live system."},"warnings":[{"fix":"Separate command and arguments using -- syntax: vng -- uname -r instead of vng --exec uname -r","message":"In v1.36, --exec and positional arguments became mutually exclusive. Using both will raise an error.","severity":"breaking","affected_versions":">=1.36"},{"fix":"Run `git submodule deinit virtme-ng-init` and `git rm virtme-ng-init` to clean up old submodule.","message":"The virtme-ng-init repository has been merged into main project as of v1.33. Old git submodule references are obsolete.","severity":"deprecated","affected_versions":"<1.33"},{"fix":"Use `--ssh` option to force legacy TCP SSH, or ensure kernel has vsock support.","message":"Default SSH transport uses vsock; if guest lacks vsock support, SSH will fail.","severity":"gotcha","affected_versions":">=1.34"},{"fix":"Upgrade to v1.38 or later.","message":"Stale file handle errors (ESTALE) were common with virtiofsd before v1.38. If you see this, upgrade.","severity":"gotcha","affected_versions":"<1.38"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use 'from virtme_ng.run import VirtmeNGConfig'.","cause":"Trying to import VirtmeNGConfig from the top-level virtme_ng package instead of virtme_ng.run.","error":"ImportError: cannot import name 'VirtmeNGConfig' from 'virtme_ng'"},{"fix":"Use the -- syntax: vng -- uname -r instead of vng --exec uname -r.","cause":"Using --exec together with a command string after vng, which became mutually exclusive in v1.36.","error":"vng: error:argument --exec: not allowed with positional arguments"},{"fix":"Choose either interactive console or exec command, not both.","cause":"Trying to use both --console and --exec options at the same time.","error":"virtme-ng: error: --console and --exec are mutually exclusive"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}