Files
cheatsheet-tldr/tldr/linux/virt-sysprep
2026-01-21 00:23:19 +00:00

44 lines
1.9 KiB
Plaintext

---
syntax: markdown
tags: [tldr, linux]
source: https://github.com/tldr-pages/tldr.git
---
# virt-sysprep
> Reset, unconfigure, or customize a virtual machine image.
> This command can be used on a virtual machine or directly on a virtual machine disk image.
> Note: You may need to pass `--connect URI` to the commands or set up the URI in `$XDG_CONFIG_HOME/libvirt/libvirt.conf`.
> More information: <https://libguestfs.org/virt-sysprep.1.html>.
- List all supported operations (default enabled operations are indicated with asterisks):
`virt-sysprep --list-operations`
- Run only the specified operations:
`sudo virt-sysprep {{[-d|--domain]}} {{vm_name}} --operations {{operation1,operation2,...}}`
- Remove sensitive system data from a virtual machine image (operations marked as default):
`sudo virt-sysprep {{[-a|--add]}} {{path/to/image.qcow2}}`
- Specify a virtual machine by its name and run all enabled operations but don't actually apply the changes:
`sudo virt-sysprep {{[-d|--domain]}} {{vm_name}} {{[-n|--dry-run]}}`
- Reset NetworkManager network configurations, persistent MAC mappings, and the hostname to avoid network conflicts:
`sudo virt-sysprep {{[-d|--domain]}} {{vm_name}} --operations machine-id,net-hwaddr,net-hostname,net-nmconn,customize --hostname {{new_hostname}}`
- Set the root password for a disk image:
`sudo virt-sysprep {{[-a|--add]}} {{path/to/image.qcow2}} --operations customize --root-password password:{{new_password}}`
- Inject a new user with a defined password and add them to the sudo group:
`sudo virt-sysprep {{[-a|--add]}} {{path/to/image.qcow2}} --run-command 'useradd -m {{username}} && echo {{username}}:{{password}} | chpasswd && usermod -aG sudo {{username}}'`
- Install specific package(s) on a disk image (use `--update` to upgrade all installed packages to latest):
`sudo virt-sysprep {{[-a|--add]}} {{path/to/image.qcow2}} --operations customize --network --install {{package_name1,package_name2,...}}`