From Whonix

(Redirected from Template:VirtualBoxTesting)

1. Download Whonix ™ Whonix old logo.png {{{flavor}}} for Windows Windows logo - 2012.svg.png, MacOS Rsz osx.png and Linux Tux.png FREE

Ambox warning pn.svg.png By downloading, you acknowledge that you have read, understood and agreed to our Terms of Service and License Agreement.

Version: {{{version}}}

{{{project}}} ™
Download Security
without [[#Verify the {{{project}}} images|Verification]]
Download Security
with [[#Verify the {{{project}}} images|Verification]]
Https long.png


Medium High [1]
Button sig.png

OpenPGP Signature ( sha512 , sig )

- -
Crypto key.png Verify images using this Signing Key -

Verify the Whonix ™ Images Whonix ™ virtual machine images are cryptographically signed by Whonix developer Patrick Schleizer using OpenPGP. [2]

notice Digital signatures can increase security but this requires knowledge. Learn more about digital software signature verification.

If you know how to use an OpenPGP key, download the Whonix ™ Signing Key and the Whonix ™ signatures straight away.

Otherwise, use the following instructions:

Download {{{project}}} ™ {{{flavor}}}

2. Install VirtualBox Virtualbox logo.png

  • Linux Tux.png: please press expand on the right side.

Hosts using a non-Debian OS: Tux.png

Install VirtualBox as per the normal mechanism for your Linux distribution. Whonix ™ has has been tested with, expects VirtualBox version 6.16 or higher.

For example VirtualBox version 5.2.18 has been reported to not be compatible.

Ubuntu hosts: Logo-ubuntusvg.png

Ubuntu bionic (18.04LTS) APT repository ships only VirtualBox version 5.2.18 and Whonix ™ will probably not work.

You might want to release-upgrade to Ubuntu focal (20.04LTS) which provides VirtualBox version 6.16.

Debian hosts: Debian.png

These instructions are for Debian buster, which is recommended. Other Debian releases might work, but this is untested. In that case, replace buster with the actual codename your release.

Note: this applies to Whonix ™ 15. Later Whonix ™ versions may use a codename different to buster.

Package virtualbox should be installed from Whonix repository. [3]

1. On the host.

Open a terminal.

2. Add Whonix ™ repository.

A) Download the Signing Key.


B) Optional: Check the Signing Key for better security.

C) Add Whonix's signing key.

sudo apt-key --keyring /etc/apt/trusted.gpg.d/whonix.gpg add ~/patrick.asc

D) Add Whonix's APT repository.

echo "deb buster main contrib non-free" | sudo tee /etc/apt/sources.list.d/whonix.list

3. Update the package lists.

sudo apt-get update

4. Install VirtualBox and Linux kernel headers.

sudo apt-get install virtualbox linux-headers-$(dpkg --print-architecture)

The procedure is now complete.

3. Import Whonix ™ Whonix old logo.png into VirtualBox Virtualbox logo.png

For Whonix ™ VirtualBox import instructions, please press on expand on the right.

Start VirtualBox

Click on File then choose Import Appliance...
Select Import2.png

Navigate and select Whonix ™ image and press next
Select whonix ova image3.png

Do NOT change anything! Just click on Import
Click import4.png

Then press Agree

Wait until Whonix ™ .ova has been imported

Now start both Whonix-Gateway ™ and Whonix-Workstation ™
Start both of them7.png


There are also Video Tutorials.

If you still need help, please check the Support page.

For command line import instructions, see footnote. [4]

4. Start Whonix ™

Starting Whonix ™ is simple.

Start VirtualBoxDouble-click the Whonix-Gateway ™ and Whonix-Workstation ™.

  1. It does not matter if the bulk download is done over an insecure channel if OpenPGP verification is used at the end.
  2. OpenPGP is a standard for data encryption that provides cryptographic privacy and authentication through the use of keys owned by its users.
  3. This is non-ideal but required since VirtualBox in unavailable in Debian buster / buster-backports. And it will not become available anytime soon either. See Unavailable in Debian stable and backports due to Licensing Issues. There is a chance VirtualBox will be available from Debian fasttrack [archive], see please add VirtualBox to fasttrack [archive]. Alternatively you could but this comes with different risks.
  4. On the Linux platform.
    1. Read License Agreement:
    vboxmanage import Whonix-XFCE- --vsys 0 --eula show --vsys 1 --eula show

    2. Import Whonix-Gateway ™ and Whonix-Workstation ™.

    vboxmanage import Whonix-XFCE- --vsys 0 --eula accept --vsys 1 --eula accept