qvm-backup-restore – Restores Qubes VMs from backup¶
Warning
This page was autogenerated from command-line parser. It shouldn’t be 1:1
conversion, because it would add little value. Please revise it and add
more descriptive help, which normally won’t fit in standard --help
option.
After rewrite, please remove this admonition.
Synopsis¶
qvm-backup-restore [options] <backup-dir>
Options¶
- --help, -h¶
Show this help message and exit
- --verbose, -v¶
Increase verbosity
- --quiet, -q¶
Decrease verbosity
- --verify-only¶
Do not restore the data, only verify backup integrity
- --skip-broken¶
Do not restore VMs that have missing templates or netvms
- --ignore-missing¶
Ignore missing templates or netvms, restore VMs anyway
- --skip-conflicting¶
Do not restore VMs that are already present on the host
- --rename-conflicting¶
Restore VMs that are already present on the host under different names
- --exclude=EXCLUDE, -x EXCLUDE¶
Skip restore of specified VM (might be repeated)
- --skip-dom0-home¶
Do not restore dom0 user home dir
- --ignore-username-mismatch¶
Ignore dom0 username mismatch while restoring homedir
- --ignore-size-limit¶
Backup metadata contains expected size of each VM. By default if backup contains more data than expected, it is rejected. Use this option to ignore this limit and restore such (broken, or potentially malicious) backup anyway.
- --compression-filter, -Z¶
Force specific compression filter, instead of the one named in the backup header. The compression filter is a command that accepts
-d
option to decompress data on stdin and output it to stdout. This can be used to override built-in protection against uncommon compression.
- --dest-vm=APPVM, -d APPVM¶
Restore from a backup located in a specific AppVM
- --passphrase-file, -p¶
Read passphrase from file, or use ‘-’ to read from stdin
- --location-is-service¶
Provided backup location is a qrexec service name (optionally with an argument, separated by
+
), instead of file path or a command.
- --paranoid-mode, --plan-b¶
Isolate restore process in a DisposableVM, defend against potentially compromised backup. In this mode some parts of the backup are skipped, specifically:
dom0 home directory (desktop environment settings)
PCI devices assignments
- --auto-close¶
When running with –paranoid-mode (see above), automatically close restore progress window after the restore process is finished and display restore log on the standard output. The log will be colored red if the standard output is a terminal.