Last update: March 17, 2019. This website uses cookies. 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



VM Settings Easy Common

This is the easiest, but least secure option. (#more security)

For Qubes-Whonix, click on Expand on the right.

1. Create a new VM.

2. Set sys-whonix as your VM's NetVM.

Qube Manager -> right-click vm-name -> NetVM -> sys-whonix -> OK [1]

For Non-Qubes-Whonix, click on Expand on the right.

Download and Use the Default Whonix-Gateway

Download and import the Whonix-Gateway using the same procedure as per the Whonix-Default / Download-Version. No other Whonix-Gateway changes are required in this case!

Set up a Whonix-Custom-Workstation

There are currently two ways to set up a Whonix-Custom-Workstation. Either:

  1. Manually create a VirtualBox VM (established, old method).
  2. Download and import a Whonix-Custom-Workstation (stable method).

Users who want to manually create a VirtualBox VM using the established and old method, click on Expand on the right.

1. Create a VirtualBox VM

Follow these steps in order:

VirtualBox -> Machine -> New -> Next -> Enter Name (for example, myVM) -> Enter Operating System and Version -> Next -> Define RAM -> Next -> Create a new HDD (or not) -> Next -> Disk format doesn't matter (VDI works well) -> Next -> Set dynamically or fixed size preference -> Next -> Set HDD size and location preference -> Next -> Create

2. Switch VirtualBox VM Settings

Follow these steps in order:

  • Choose the newly created VM (for example, myVM) -> Settings -> System -> Motherboard -> Hardware Clock in UTC
  • System -> Motherboard -> Pointing Device -> PS/2 Mouse (required to disable the USB controller)
  • System -> Processor -> Enable PAE/NX (if available)
  • Network -> Adapter 1 -> Attached to Internal Network (important!)
  • Network -> Adapter 1 -> Name (of Internal Network) (important!): Whonix [2]
  • USB -> Uncheck Enable USB controller
  • -> OK

Users who want to download and import a Whonix-Custom-Workstation template using the stable method, click on Expand on the right.

This method's advantage is that there is need to manually create a new VM. The process is greatly simplified; the Whonix-Custom-Workstation only needs to be downloaded and imported. This approach has several benefits: it is easier, all security settings are set for the VM, and users don't have to remember and apply necessary settings.

The latest Whonix-Custom-Workstation Version is:

Although the version number for Whonix-Gateway and Whonix-Default / Download-Version might be far higher than the Whonix-Custom-Workstation version, this is normal. [3]

1. Download the Whonix-Custom-Workstation

Download the following image.


2. Download the OpenPGP Signature

Download the corresponding OpenPGP signature.

OpenPGP Signature

3. Verify the Whonix Image

Follow these steps to verify the Whonix image.

4. Import and Rename the Virtual Machine

After importing the image, rename the virtual machine to something else. [4] VirtualBox -> Right-click on VM -> Settings -> Name (for example: myVM)

If this method was used, please report how well it worked in the Whonix forum.

Start VM and Install Operating System

  1. Start the newly created VM (for example: myVM).
  2. Insert the installation DVD.
  3. Updates don't have to installed while installing the OS. Post-install, apply updates after the network has been set up.
  4. The username is: user. The computer name is: host
    1. qubes-prefs --set vm-name netvm sys-whonix
    2. Note: It is Whonix, not whonix. Capital W case sensitivity matters.
    3. A newer Whonix-Custom-Workstation only needs to be redistributed if the settings for the VM have changed. For example, these have not changed between Whonix 9 and Whonix 13. Therefore, Whonix-Custom-Workstation version is recent enough to function, because it comes with an empty virtual hard drive (meaning software cannot be outdated).
    4. It is not strictly necessary to rename the VM at this point, but this prevents potential naming conflicts if another Whonix-Custom-Workstation is imported later on.