Actions

Uninstall Qubes-Whonix

< Qubes

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).

Qubes-whonix1.png

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).

Qubes-whonix1.png

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]


This matters in the case of customized TemplateVMs. If that applies, strongly consider backups of anything important before proceeding.

Whonix-Gateway[edit]

  1. Open a dom0 terminal: Qubes App Launcher (blue/grey "Q") -> System Tools -> Xfce Terminal
  2. 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]

  1. Open a dom0 terminal: Qubes App Launcher (blue/grey "Q") -> System Tools -> Xfce Terminal
  2. 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]

  1. Open a dom0 terminal: Qubes App Launcher (blue/grey "Q") -> System Tools -> Xfce Terminal
  2. 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]

  1. Or if deciding not to use Whonix at all.
  2. qvm-shutdown vm-name
  3. qvm-prefs --set vm-name template dummy
  4. qvm-remove vm-name
  5. 6.0 6.1 6.2 Note the matching syntax below and the effect of running qubes-template-whonix-gw* or qubes-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)
    Wildcards are used so these instructions are valid for all old and future versions of Whonix. Alternatively, the asterisk * syntax could be replaced with a specific template package listed above.

Random News:

Want to make Whonix safer and more usable? We're looking for helping hands. Check out the Open Issues and development forum.


https | (forcing) onion

Share: Twitter | Facebook

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?)