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.

Authors

Joanna Rutkowska <joanna at invisiblethingslab dot com>
Rafal Wojtczuk <rafal at invisiblethingslab dot com>
Marek Marczykowski <marmarek at invisiblethingslab dot com>