{{Header}} {{hide_all_banners}}
{{title|title=
Uninstall {{project_name_short}}
}}
{{#seo:
|description=Guide on how to uninstall {{project_name_short}}
|image=Qubesunintall123123.png
}}
[[File:Qubesunintall123123.png|thumb|200px]]
<div class="mininav">
* [[Uninstall|Uninstall {{non_q_project_name_short}}]]
* [[Qubes/Uninstall|Uninstall {{q_project_name_short}}]]
</div>
{{intro|
A step-by-step guide to uninstalling {{project_name_short}}.
}}

<div style="font-size:180%; font-weight:bold; margin-top:1em;">Removing Whonix</div>

From time to time, users inquire about the process of uninstalling {{project_name_short}}, possibly as a precursor to a {{Kicksecure_wiki
|wikipage=Factory_Reset
|text=Factory Reset
}} (reinstallation).

Here's how to uninstall {{project_name_short}}:

<u>Note:</u> The following instructions are [[unspecific|generic, not unique to {{project_name_short}}]]. They pertain to typical operations associated with virtualization software, and no additional steps are specifically required for {{project_name_short}}.

= 1.''' '''Remove the {{project_name_short}} VMs.=

You can simply delete the VMs you wish to remove using the virtual machine manager {{gui}}.

Select your platform.

{{Tab
|type=controller
|linkid=link1
|content=
{{Tab
|title= == VirtualBox ==
|image=[[File:Virtualbox_logo.png|25px]]
|addToClass=info-box
|content=
Start Oracle VM VirtualBox Manager.

'''Figure:''' ''Whonix in Oracle VM VirtualBox Manager''

<u>Note:</u> Screenshots might look slightly different.

[[File:Whonix_Oracle_VM_VirtualBox_Manager.png|400px|Whonix in Oracle VM VirtualBox Manager]]

Right-click on a VM name.

'''Figure:''' ''VirtualBox delete VM''

<u>Note:</u> VM names will look different than in the screenshot.

[[File:Virtualbox_delete_vm.jpeg|400px|VirtualBox delete VM]]

}} <!-- close tab: Virtualbox Remove the VMs  -->

{{Tab
|title= == KVM ==
|image=[[File:Kvm-new-logo.png|25px]]
|addToClass=info-box
|content=

[[Undocumented]].

}} <!-- close tab: KVM Remove the VMs -->

{{Tab
|title= == Qubes ==
|image=[[File:Qubes-logo-icon.png|25px]]
|addToClass=info-box
|content=

[[Qubes/Uninstall|Uninstall {{q_project_name_short}}]].

}} <!-- close tab: Qubes Remove the VMs -->
}} <!-- close tabs: VirtualBox & KVM & Qubes Remove the VMs -->

= 2.''' '''Uninstall the virtualization software. =

<u>Optional.</u>

The method for this varies based on your host operating system. It is [[unspecific|unspecific to {{project_name_short}}]] and should be done according to the [[Self Support First Policy]].

{{Tab
|type=controller
|linkid=link1
|content=
{{Tab
|title= == VirtualBox ==
|image=[[File:Virtualbox_logo.png|25px]]
|addToClass=info-box
|content=
Uninstall VirtualBox.

{{CodeSelect|code=
sudo apt-get remove --purge virtualbox*
}}

<u>Optional.</u>

Delete group <code>vboxusers</code> and <code>vboxsf</code>.

{{CodeSelect|code=
sudo groupdel vboxusers
}}

{{CodeSelect|code=
sudo groupdel vboxsf
}}

}} <!-- close tab: VirtualBox Uninstall the virtualization software -->

{{Tab
|title= == KVM ==
|image=[[File:Kvm-new-logo.png|25px]]
|addToClass=info-box
|content=

[[Undocumented]].

}} <!-- close tab: KVM Uninstall the virtualization software -->

{{Tab
|title= == Qubes ==
|image=[[File:Qubes-logo-icon.png|25px]]
|addToClass=info-box
|content=

See [[Qubes/Uninstall|Uninstall {{q_project_name_short}}]].
}} <!-- close tab: Qubes Uninstall the virtualization software -->
}} <!-- close tabs: VirtualBox, KVM, Qubes Uninstall the virtualization software -->

= 3.''' '''Remove virtualizer related files. =

Optional.

{{Tab
|type=controller
|linkid=link1
|content=
{{Tab
|title= == VirtualBox ==
|image=[[File:Virtualbox_logo.png|25px]]
|addToClass=info-box
|content=

* File in the user home folder that can be considered for deletion (installer) (VirtualBox VMs folder):
** <code>VirtualBox VMs</code>
*** But the user should be careful if any non-{{project_name_short}} VMs were used. These are stored in the same folder.
* Hidden folder in the user home folder that can be considered for deletion (VirtualBox settings folder):
** <code>.config/VirtualBox</code>
*** Similar to above.
*** Folder <code>.config</code> is a "hidden folder". Many file managers do not show hidden folders by default. This can usually be adjusted in the settings of the file manager.
* VirtualBox documentation: [https://www.virtualbox.org/manual/ch10.html Where Oracle VM VirtualBox Stores its Files]
}} <!-- close tab: VirtualBox remove virtualizer related files -->

{{Tab
|title= == KVM ==
|image=[[File:Kvm-new-logo.png|25px]]
|addToClass=info-box
|content=

[[Undocumented]].
}} <!-- close tab: KVM remove virtualizer related files -->

{{Tab
|title= == Qubes ==
|image=[[File:Qubes-logo-icon.png|25px]]
|addToClass=info-box
|content=

Not applicable.
}} <!-- close tab: Qubes remove virtualizer related files -->
}} <!-- close tabs: VirtualBox, KVM, Qubes remove virtualizer related files -->

= 4.''' '''Remove installer related files. =

Optional.

{{Tab
|type=controller
|linkid=link1
|content=
{{Tab
|title= == VirtualBox ==
|image=[[File:Virtualbox_logo.png|25px]]
|addToClass=info-box
|content=

Only applicable if the user has used [[Linux|{{project_name_short}} for Linux Installer]].

* File in the user home folder that can be deleted (installer program): <code>whonix-xfce-installer-cli</code>
* Folder in the user home folder that can be deleted (installer downloaded files and logs folder): <code>dist-installer-cli-download</code>

}} <!-- close tab: VirtualBox remove installer related files -->

{{Tab
|title= == KVM ==
|image=[[File:Kvm-new-logo.png|25px]]
|addToClass=info-box
|content=

[[Undocumented]].

}} <!-- close tab: KVM remove installer related files -->

{{Tab
|title= == Qubes ==
|image=[[File:Qubes-logo-icon.png|25px]]
|addToClass=info-box
|content=

Not applicable.

}} <!-- close tab: Qubes remove installer related files -->

}} <!-- close tab: VirtualBox, KVM, Qubes remove installer related files -->

= 5.''' '''Completion.=

At this point, the uninstallation process is complete.

= See Also =
* {{Kicksecure_wiki
|wikipage=Factory_Reset
|text=Factory Reset
}}

{{reflist|close=1}}
{{Footer}}
[[Category:Documentation]]