Qubes-Whonix ™ Overview
In this configuration Whonix ™ runs on top of Qubes inside virtual machines (VMs), just like any other OS on the same platform (Fedora, Debian, Arch Linux and so on).
The Qubes bare-metal hypervisor is based on Xen and Fedora. Via hardware support like VT-x and VT-d Qubes has successfully implemented a comprehensive yet strict security-by-isolation architecture. Hardware controllers and multiple user domains (qubes) are isolated using separate VMs that are explicitly assigned different levels of trust, yet the desktop experience is user-friendly and well-integrated.
Whonix ™ is based on Debian and Tor. The design provides a two-VM, split security architecture: an isolated Whonix-Gateway ™ (ProxyVM;
sys-whonix) for complete routing of traffic over Tor; and Whonix-Workstation ™ (App Qube;
anon-whonix) for all desktop applications, which serves as a tailored OS environment for Tor-based privacy/anonymity.
To use Qubes-Whonix ™, Qubes must first be installed as a hypervisor on the physical host computer, followed by installation of the two separate Whonix ™ Templates --
whonix-ws-16 -- on top of Qubes. From this point, the Whonix ™ Templates can be used for customization and creation of multiple Whonix-Gateway ™ ProxyVMs and Whonix-Workstation ™ AppVMs, enabling enhanced compartmentalization of user activities for better privacy. 
For a more in-depth consideration of Qubes-Whonix ™ advantages, see: Why use Qubes over other Virtualizers?
Figure: Qubes OS Design 
For major Template and AppVM operations, refer to the following guides:
- Install Qubes-Whonix ™
- Update Qubes-Whonix ™
- Update Tor Browser
- Reinstall Qubes-Whonix ™ Templates
- Uninstall Qubes-Whonix ™ Templates
- Install and update software in dom0
- Backup, restore and migrate VMs
For improved security and anonymity after installing Qubes-Whonix ™, refer to the following guides:
Qubes (non-)persistence is a Qubes default and unspecific to Whonix ™.
Table: Qubes R4 Inheritance and Persistence
|Inheritance ||Persistence |
|Template  ||n/a||Everything|
|App Qubes ||
|Disposable Template  ||
|Disposable  ||
Qubes Template Modifications
If a Qubes template has been modified, to make changes in App Qubes based on that Template take effect, it is required to shutdown the Template and restart the App Qubes based on that Template. This is a Qubes default and unspecific to Whonix ™.
Before seeking personal support, please first search for the issue and a possible, documented solution. In many cases the issue can be solved by inspecting the phabricator issues tracker, reading Whonix ™ guides/documentation, conducting web searches, and examining past support requests.
If a search yields no results, support requests should be directed to the most appropriate forum:
- Qubes-Whonix ™-specific: Whonix ™ Qubes Forum
- Whonix ™, Debian and Tor: Whonix ™ Support
Table of Contents
- The only limitation on the number of possible VMs is available disk space.
- Upon creation.
- Following shutdown.
- The former name was Template.
- The former name was AppVM or TemplateBasedVM.
- Former names included DisposableVM Template, DVM Template, and DVM.
- Former names included DisposableVM and DispVM.
- The former discourse forum was discontinued on 1 July, 2021.