qubes-doc/privacy/whonix-install.md

---
layout: doc
title: Install Whonix in Qubes
permalink: /doc/whonix/install/
redirect_from: /doc/privacy/install-whonix/
---


Install Whonix in Qubes
=======================

Installing Whonix in Qubes is simple and only requires a few simple steps.

### First Time Users

Using privacy and anonymization tools like Whonix is not a magical solution that instantly makes you anonymous online. Please consider:

* Do you know what metadata or a man-in-the-middle attack is?
* Do you think nobody can eavesdrop on your communications because you are using Tor?
* Do you know how Whonix works?

If you answered no, have a look at the [about](https://www.whonix.org/wiki/About), [warning](https://www.whonix.org/wiki/Warning) and [do not](https://www.whonix.org/wiki/DoNot) pages (on the Whonix website) to make sure Whonix is the right tool for you and you understand  it's limitations.

---

### Install Templates

Launch the `dom0` terminal `Konsole` from your Qubes App Launcher. Then enter the following command to install the Whonix-Gateway and Workstation TemplateVMs.

~~~
sudo qubesctl state.sls qvm.anon-whonix
~~~

Download will take a while and there will be no progress indicator.

After doing this, you should see two new TemplateVMs in the VM Manager called `whonix-gw` and `whonix-ws` as well as a `whonix-gw` TemplateBased ProxyVM called `sys-whonix` as well as a `whonix-ws` based AppVM called `anon-whonix`.

### Enabling AppArmor

This is an optional security enhancement (for testers-only). If you’re technical & interested, see [Enabling AppArmor](/doc/privacy/customizing-whonix/).

### Running Applications

To start an application in the **anon-whonix AppVM**, launch it like any other - open the `Qubes App Launcher` and then select an app such as `Tor Browser`.

### Advanced Information

You can learn more about [installing Whonix](https://www.whonix.org/wiki/Qubes/Install), [Qubes-Whonix](https://www.whonix.org/wiki/Qubes) or [Whonix generally](https://www.whonix.org).
-												started porting over Whonix documentation QubesOS/qubes-issues#1201 QubesOS/qubes-issues#1202

											
										
										
											2015-12-02 12:56:13 -05:00
+								---
 								layout: doc
 								title: Install Whonix in Qubes
-												Clean up and organize privacy pages

* Logically organize the Whonix-related pages
* Move the VPN page to /configuration/
  * VPNs are used for more than just privacy, and many VPN setups and
    services either can't or don't claim to provide privacy.
* Remove `/privacy/` from URLs
  * These directory names are just for organizing the source pages,
    *unless* an actual page resides there. Since there is no
    /doc/privacy/ page, it's unnecessary and misleading to have this in
    the URLs. It also breaks uniformity, since none of the other pages
    have their informal group name in their URL (again, unless there's
    a page with that name).

											
										
										
											2016-02-20 16:15:30 -05:00
+								permalink: /doc/whonix/install/
 								redirect_from: /doc/privacy/install-whonix/
-												started porting over Whonix documentation QubesOS/qubes-issues#1201 QubesOS/qubes-issues#1202

											
										
										
											2015-12-02 12:56:13 -05:00
+								---
 								Install Whonix in Qubes
 								=======================
 								Installing Whonix in Qubes is simple and only requires a few simple steps.
 								### First Time Users
 								Using privacy and anonymization tools like Whonix is not a magical solution that instantly makes you anonymous online. Please consider:
-												Fix a few typos

											
										
										
											2016-01-10 18:41:30 -05:00
+								* Do you know what metadata or a man-in-the-middle attack is?
-												started porting over Whonix documentation QubesOS/qubes-issues#1201 QubesOS/qubes-issues#1202

											
										
										
											2015-12-02 12:56:13 -05:00
+								* Do you think nobody can eavesdrop on your communications because you are using Tor?
 								* Do you know how Whonix works?
 								If you answered no, have a look at the [about](https://www.whonix.org/wiki/About), [warning](https://www.whonix.org/wiki/Warning) and [do not](https://www.whonix.org/wiki/DoNot) pages (on the Whonix website) to make sure Whonix is the right tool for you and you understand  it's limitations.
 								---
 								### Install Templates
-												fixed spelling, reintroduced '-' for Whonix VM names

https://github.com/QubesOS/qubes-doc/pull/62#issuecomment-161467387

											
										
										
											2015-12-09 11:12:02 -05:00
+								Launch the `dom0` terminal `Konsole` from your Qubes App Launcher. Then enter the following command to install the Whonix-Gateway and Workstation TemplateVMs.
-												started porting over Whonix documentation QubesOS/qubes-issues#1201 QubesOS/qubes-issues#1202

											
										
										
											2015-12-02 12:56:13 -05:00
 								~~~
-												install Whonix using salt

https://github.com/QubesOS/qubes-issues/issues/3447
											
										
										
											2018-01-06 09:50:42 -05:00
+								sudo qubesctl state.sls qvm.anon-whonix
-												started porting over Whonix documentation QubesOS/qubes-issues#1201 QubesOS/qubes-issues#1202

											
										
										
											2015-12-02 12:56:13 -05:00
+								~~~
-												document that there is no progress indicator

since this caused a confused user to ask on the mailing list

											
										
										
											2016-01-20 10:00:53 -05:00
+								Download will take a while and there will be no progress indicator.
-												install Whonix using salt

https://github.com/QubesOS/qubes-issues/issues/3447
											
										
										
											2018-01-06 09:50:42 -05:00
+								After doing this, you should see two new TemplateVMs in the VM Manager called `whonix-gw` and `whonix-ws` as well as a `whonix-gw` TemplateBased ProxyVM called `sys-whonix` as well as a `whonix-ws` based AppVM called `anon-whonix`.
-												started porting over Whonix documentation QubesOS/qubes-issues#1201 QubesOS/qubes-issues#1202

											
										
										
											2015-12-02 12:56:13 -05:00
-												Update install-whonix.md
											
										
										
											2015-12-09 14:56:44 -05:00
+								### Enabling AppArmor
 								This is an optional security enhancement (for testers-only). If you’re technical & interested, see [Enabling AppArmor](/doc/privacy/customizing-whonix/).
-												started porting over Whonix documentation QubesOS/qubes-issues#1201 QubesOS/qubes-issues#1202

											
										
										
											2015-12-02 12:56:13 -05:00
+								### Running Applications
-												install Whonix using salt

https://github.com/QubesOS/qubes-issues/issues/3447
											
										
										
											2018-01-06 09:50:42 -05:00
+								To start an application in the **anon-whonix AppVM**, launch it like any other - open the `Qubes App Launcher` and then select an app such as `Tor Browser`.
-												started porting over Whonix documentation QubesOS/qubes-issues#1201 QubesOS/qubes-issues#1202

											
										
										
											2015-12-02 12:56:13 -05:00
 								### Advanced Information
-												Update install-whonix.md
											
										
										
											2015-12-09 14:56:44 -05:00
+								You can learn more about [installing Whonix](https://www.whonix.org/wiki/Qubes/Install), [Qubes-Whonix](https://www.whonix.org/wiki/Qubes) or [Whonix generally](https://www.whonix.org).