Uninstall Qubes-Whonix
< Qubes
Contents
Introduction[edit]
This procedure is useful before a complete re-installation of Qubes-Whonix. [1]
Note that removal or recreation of Whonix ProxyVMs (sys-whonix) and AppVMs (anon-whonix) is a separate issue. TODO: document removal
Remove the Whonix-Workstation DVM Template[edit]
The whonix-ws-14-dvm domain must be manually removed.
In the case of customized Whonix-Workstation DVM Template, strongly consider backups of anything important before proceeding.
To launch a dom0 terminal, click the Qubes App Launcher (blue/grey "Q") and then open the Terminal Emulator (Xfce Terminal).
Set the default DispVM for whonix-ws-14-dvm to "".
qvm-prefs whonix-ws-14-dvm default_dispvm ""
Remove whonix-ws-14-dvm.
qvm-remove whonix-ws-14-dvm
The process of removing whonix-ws-14-dvm is now complete.
Stop using Whonix TemplateVMs in VM Template Settings[edit]
If a Whonix TemplateVM is set as the underlying TemplateVM for any VMs, the TemplateVM cannot be removed. Either:
- Option A: Unset the TemplateVM using Qube Manager:
The advantage of setting a dummy template as the TemplateVM is the ability to retain any VMs, along with the user storage contents.
1. Create the dummy TemplateVM. [2]
To launch a dom0 terminal, click the Qubes App Launcher (blue/grey "Q") and then open the Terminal Emulator (Xfce Terminal).
Execute the following commands.
Qubes R3.2:
mkdir -p /var/lib/qubes/vm-templates/dummy
touch /var/lib/qubes/vm-templates/dummy/{root.img,private.img}
qvm-add-template dummy
Qubes R4:
qvm-create --class TemplateVM --label red dummy
The process of creating the dummy TemplateVM is now complete.
2. Shut down the Whonix TemplateVM if already running: Qube Manager -> right-click Whonix TemplateVM -> Shutdown qube [3]
3. Set the dummy template as the TemplateVM: right-click VM -> Qube settings -> Template: dummy [4]
The process of setting the TemplateVM of the VM to the dummy template is now complete.
}}
OR
- Option B: Delete the VMs that depend on the Whonix template(s):
Qube Manager -> right-click Whonix TemplateVM -> Delete qube [5]
Uninstall Whonix TemplateVMs[edit]
 | Note that the root filesystem will be lost when uninstalling the TemplateVM. |
This matters in the case of customized TemplateVMs. If that applies, strongly consider backups of anything important before proceeding.
Whonix-Gateway[edit]
- Open a dom0 terminal:
Qubes App Launcher (blue/grey "Q")->System Tools->Xfce Terminal - Uninstall all Qubes-Whonix-Gateway template packages matching
qubes-template-whonix-gw*: [6]
sudo dnf remove qubes-template-whonix-gw*
Review the dnf confirmation output before proceeding.
Whonix-Workstation[edit]
- Open a dom0 terminal:
Qubes App Launcher (blue/grey "Q")->System Tools->Xfce Terminal - Uninstall all Qubes-Whonix-Workstation template packages matching
qubes-template-whonix-ws*: [6]
sudo dnf remove qubes-template-whonix-ws*
Review the dnf confirmation output before proceeding.
All Whonix Template Packages[edit]
- Open a dom0 terminal:
Qubes App Launcher (blue/grey "Q")->System Tools->Xfce Terminal - Uninstall all Qubes-Whonix template packages matching
qubes-template-whonix*: [6]
sudo dnf remove qubes-template-whonix*
Review the dnf confirmation output before proceeding.
Footnotes[edit]
- ↑ Or if deciding not to use Whonix at all.
- ↑
- ↑
qvm-shutdown vm-name
- ↑
qvm-prefs --set vm-name template dummy
- ↑
qvm-remove vm-name
- ↑ 6.0 6.1 6.2
Note the matching syntax below and the effect of running
qubes-template-whonix-gw*orqubes-template-whonix-ws*. Also note the asterisk*wildcard at the end. Depending on the Whonix version, this leads to multiple template packages being uninstalled if they are present:qubes-template-whonix-gw(Whonix 13)qubes-template-whonix-ws(Whonix 13)qubes-template-whonix-gw-14(stable Whonix release)qubes-template-whonix-ws-14(stable Whonix release)qubes-template-whonix-gw-15(future Whonix release)qubes-template-whonix-ws-15(future Whonix release)
*syntax could be replaced with a specific template package listed above.
Want to make Whonix safer and more usable? We're looking for helping hands. Check out the Open Issues and development forum.
This is a wiki. Want to improve this page? Help is welcome and volunteer contributions are happily considered! See Conditions for Contributions to Whonix, then Edit! IP addresses are scrubbed, but editing over Tor is recommended. Edits are held for moderation.
Whonix is a licensee of the Open Invention Network. Unless otherwise noted, the content of this page is copyrighted and licensed under the same Libre Software license as Whonix itself. (Why?)