Actions

Uninstall Qubes-Whonix ™

From Whonix

< Qubes



Qubesunintall123123.png

Introduction[edit]

This procedure is useful before a complete re-installation of Qubes-Whonix ™. [1]

Alternatively, it is possible to Reinstall Qubes-Whonix ™ Templates without a complete uninstallation of Whonix ™ as documented on this page.

Before Qubes-Whonix ™ Template packages can be uninstalled, the Template must not be used as the underlying template by any VMs (otherwise Qubes prohibits removal). Therefore, either delete the VMs as documented below or follow the step to: Stop using Whonix ™ Templates in VM Template Settings.

Users can replace version 16 with 15 or any other version number if that is the goal.

Whonix-Workstation ™ Removal[edit]

Remove Whonix-Workstation ™ App Qubes[edit]

The anon-whonix Whonix-Workstation ™ App Qube [2] must be manually removed. Alternatively, you can Stop using Whonix ™ Templates in VM Template Settings.

If anon-whonix was previously used, strongly consider backups of any important files before proceeding.

1. Remove anon-whonix.

  • Qube Manager → right-click Whonix ™ App Qube anon-whonix → Delete qube [3]

2. Repeat the above step for any other App Qubes based on Whonix-Workstation ™ Template whonix-ws-16 that were created earlier. Replace vm-name with the actual name of the VM.

  • Qube Manager → right-click Whonix ™ App Qube vm-name → Delete qube [4]

Remove the Whonix-Workstation ™ Disposable Template[edit]

The whonix-ws-16-dvm domain must be manually removed. Alternatively, you can Stop using Whonix ™ Templates in VM Template Settings.

In the case of a customized Whonix-Workstation ™ Disposable Template, strongly consider backups of any important files before proceeding.

Launch a dom0 terminal.
Click the Qubes App Launcher (blue/grey "Q") → Open the Terminal Emulator (Xfce Terminal)

Qubes-whonix1.png

1. Set the default Disposable for anon-whonix to "". This is only required if you chose to skip removal of anon-whonix as documented above. 

qvm-prefs anon-whonix default_dispvm ""

2. Repeat the above step for all other App Qubes that are based on Whonix-Workstation ™ Template whonix-ws-16 that were created earlier. Replace vm-name with the actual name of the VM. 

qvm-prefs vm-name default_dispvm ""

3. Set the default Disposable for whonix-ws-16-dvm to "". 

qvm-prefs whonix-ws-16-dvm default_dispvm ""

4. Remove whonix-ws-16-dvm. 

qvm-remove whonix-ws-16-dvm

5. The process of removing whonix-ws-16-dvm is now complete.

Whonix-Gateway ™ Removal[edit]

Stop using Whonix-Gateway ™ as Qubes UpdateVM[edit]

Set Qubes dom0 UpdateVM to sys-firewall or any VM of your choice.

Note: Upgrades will be no longer torified.

This is only required if you previously elected to update dom0 through Whonix ™. Regardless, it is a good idea to check the Qubes dom0 UpdateVM setting.

  • Qubes Manager → System → Global Settings → Dom0 UpdateVM: sys-firewall → OK [5]

Stop using Whonix-Gateway ™ as NetVM for any VM[edit]

If you configured any VM to use sys-whonix as NetVM, this change must be undone.

Note: The VM's traffic will be no longer torified.

This is only required if you previously elected to torify a VM's network traffic through Whonix ™. Regardless, it is a good idea to check the NetVM setting of Qubes VMs.

To set the NetVM of any VM to None, in other words, to disable networking.

Qube Manager → right-click vm-name → Qube settings → NetVM → None → OK [6]

Alternatively, you can set the NetVM to sys-firewall or another ProxyVM of your choice. However, traffic will not be torified (unless you are using cloned VMs).

Remove Whonix-Gateway ™ ProxyVMs[edit]

The sys-whonix Whonix-Gateway ™ ProxyVM [2] must be manually removed. Alternatively, you could Stop using Whonix ™ Templates in VM Template Settings.

In the case of a previously used sys-whonix ProxyVM, consider backups before proceeding. This might be a custom Tor configuration, Onion Services configuration, Bridges configuration or Tor data for persistent Tor Entry Guards.

1. Remove sys-whonix.

  • Qube Manager → right-click sys-whonix → Delete qube [7]

2. Repeat the above step for any other ProxyVM based on Whonix-Gateway ™ Template whonix-gw-16 that was created earlier. Replace vm-name with the actual name of the VM.

  • Qube Manager → right-click vm-name → Delete qube [8]

Qubes Adjustments[edit]

Stop using Whonix ™ Templates in VM Template Settings[edit]

If a Whonix ™ Template is set as the underlying Template for any VMs, the Template cannot be removed. Therefore, either delete the VM as documented above or unset the Template using Qube Manager. [9]

The VMs can optionally be set to use a dummy template. The advantage of setting a dummy template as the underlying Template is the ability to retain any VMs, along with the user storage contents.

1. Create the dummy TemplateVM. [10]

Launch a dom0 terminal.
Click the Qubes App Launcher (blue/grey "Q") → Open the Terminal Emulator (Xfce Terminal)

Qubes-whonix1.png

Execute the following commands.

  • Qubes R4: 
    qvm-create --class TemplateVM --label red dummy

  • Qubes R4.1: This might be a default functionality of Qubes VM Manager. Unspecific to Qubes-Whonix ™.

The process of creating the dummy TemplateVM is now complete.

2. Shut down the Whonix ™ Template if already running.

  • Qube Manager → right-click Whonix ™ Template → Shutdown qube [11]

3. Set the dummy template as the Template.

  • right-click VM → Qube settings → Template: dummy [12]

The process of setting the dummy template as the VM's underlying Template is complete.

Stop using Whonix-Gateway ™ for Torified Template Updates[edit]

Info Skip this chapter if you intend to Install Qubes-Whonix ™ again.

If you do not intend to use Qubes-Whonix ™ again, apply the following steps.

In technical terms, stop using Whonix-Gateway ™ as dom0 UpdatesProxy for any Templates. This is only required if you previously elected to update Qubes Templates through Whonix ™.

1. Open /etc/qubes-rpc/policy/qubes.UpdatesProxy with root rights.

2. Search for. 

$type:TemplateVM $default allow,target=sys-whonix

3. Comment out that line; add a hash (#) in front of it. 

#$type:TemplateVM $default allow,target=sys-whonix

[13]

4. Save.

5. The steps to remove Whonix-Gateway ™ as dom0 UpdatesProxy are complete.

Uninstall Whonix ™ Templates[edit]

Introduction[edit]

Whonix ™ first time users warning

  • Note the root filesystem will be lost when uninstalling the Template.
  • In the case of customized Templates, strongly consider creating backups of anything important before proceeding.
  • Whonix ™ (or any) Template in Qubes cannot be removed if any other VM is still using them; see Introduction.

Whonix-Gateway ™[edit]

  1. Open a dom0 terminal: Qubes App Launcher (blue/grey "Q") → System Tools → Xfce Terminal
  2. Uninstall all Qubes-Whonix ™ Whonix-Gateway ™ template packages matching qubes-template-whonix-gw*: [14]

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*: [14]

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*: [14]

sudo dnf remove qubes-template-whonix*

Review the dnf confirmation output before proceeding.

Troubleshooting[edit]

If the following error appears when removing the Templates, a manual fix is required. 

“ERROR: VM installed by package manager: template-vm-name”

For instruction on how to work around this issue, see: Remove VM Manually [archive].

Done[edit]

The process of uninstalling Qubes-Whonix ™ is now complete.

In order to use Qubes-Whonix ™ again in the future, follow the Install Qubes-Whonix ™ instructions.

Footnotes[edit]

  1. ↑ Or if deciding not to use Whonix ™ at all.
  2. ↑ 2.0 2.1 Qubes glossary [archive] documents TemplateBasedVM, TemplateBasedVMs and TemplateBasedHVM. So the spelling of TemplateBasedAppVMs and TemplateBasedProxyVMs should be correct.
  3. ↑ 
    qvm-remove anon-whonix
  4. ↑ 
    qvm-remove vm-name
  5. ↑ To revert this change, run. 
    qubes-prefs updatevm sys-firewall
  6. ↑ 
    qubes-prefs --set vm-name netvm ""
  7. ↑ 
    qvm-remove sys-whonix
  8. ↑ 
    qvm-remove vm-name
  9. ↑ Or use the command line.
  10. ↑
  11. ↑ 
    qvm-shutdown vm-name
  12. ↑ 
    qvm-prefs --set vm-name template dummy
  13. ↑ The entry 
    $tag:whonix-updatevm $default allow,target=sys-whonix

    and 

    $tag:whonix-updatevm $anyvm deny

    can remain. These will not have any effect once Qubes Templates are removed since no VM has the tag whonix-updatevm.
  14. ↑ 14.0 14.1 14.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 (deprecated Whonix ™ 13 release)
    • qubes-template-whonix-ws (deprecated Whonix ™ 13 release)
    • qubes-template-whonix-gw-14 (deprecated Whonix ™ release)
    • qubes-template-whonix-ws-14 (deprecated Whonix ™ release)
    • qubes-template-whonix-gw-15 (oldstable Whonix ™ release)
    • qubes-template-whonix-ws-15 (oldstable Whonix ™ release)
    • qubes-template-whonix-gw-16 (stable Whonix ™ release)
    • qubes-template-whonix-ws-16 (stable Whonix ™ release)
    • qubes-template-whonix-gw-17 (future Whonix ™ release)
    • qubes-template-whonix-ws-17 (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.
Fosshost is sponsors Kicksecure ™ stage server 100px
Fosshost About Advertisements

Search engines: YaCy | Qwant | ecosia | MetaGer | peekier | Whonix ™ Wiki

Follow: 1024px-Telegram 2019 Logo.svg.png Iconfinder Apple Mail 2697658.png Twitter.png Facebook.png Rss.png Reddit.jpg 200px-Mastodon Logotype (Simple).svg.png

Support: Discourse logo.png

Donate: Donate Bank Wire Paypal Bitcoin accepted here Monero accepted here Contribute

Whonix donate bitcoin.png Monero donate Whonix.png United Federation of Planets 1000px.png

Twitter-share-button.png Facebook-share-button.png Telegram-share.png Iconfinder Apple Mail 2697658.png Reddit.jpg Hacker.news.jpg 200px-Mastodon Logotype (Simple).svg.png

Have you read our Documentation, Design and Developer Portal links yet?

https link onion link Priority Support | Investors | Professional Support

Whonix ™ | © ENCRYPTED SUPPORT LP | Heckert gnu.big.png Freedom Software / Osi standard logo 0.png Open Source (Why?)

The personal opinions of moderators or contributors to the Whonix ™ project do not represent the project as a whole.

Retrieved from "https://www.whonix.org/w/index.php?title=Qubes/Uninstall&oldid=71312"
By using our website, you acknowledge that you have read, understood and agreed to our Privacy Policy, Cookie Policy, Terms of Service, and E-Sign Consent.
More information