VirtualBox

1. Download Whonix ™ {{{flavor}}} for Windows , MacOS and Linux FREE

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]]
	Download	Medium	High
	OpenPGP Signature ( sha512 , sig )	-	-
	Verify images using this Signing Key		-

Verify the Whonix ™ Images

It is important to check the integrity of the downloaded virtual machine images to ensure that neither a man-in-the-middle attack or file corruption occurred (see Download Security).

Warning:

Do not continue if verification fails! This risks using infected or erroneous files! The whole point of verification is to confirm file integrity.

Whonix virtual machine images are cryptographically signed by Whonix developer Patrick Schleizer using OpenPGP.

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:

• For Linux: Using KGpg
• For Linux: Using the command line
• For Windows
• For Mac

Windows (optional): Simple, fast → Whonix ™ Windows Installer

2. Install VirtualBox

• Windows , Mac : Download VirtualBox ^[archive] and install.

• Linux : please press expand on the right side.

Hosts using a non-Debian OS:

Install VirtualBox as per the normal mechanism for your Linux distribution.

Debian hosts:

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 ^[archive] should be installed from Debian unstable (codename: sid). This is non-ideal but required since VirtualBox in unavailable in Debian buster / buster-backports at the time of writing. It has risks such as bricking the apt package manager. Therefore users should make sure to have a backup in order to restore process functionality. Alternatively you could install VirtualBox from the Oracle Repository, but this comes with different risks.

1. On the host.

Open a terminal.

2. Add Debian stable codename buster to the apt-conf default-release.

sudo su -c "echo -e 'APT::Default-Release buster;' > /etc/apt/apt.conf.d/70defaultrelease"

sudo su -c "echo -e 'APT::Default-Release buster;' > /etc/apt/apt.conf.d/70defaultrelease"

3. Add Debian sid to Debian apt sources.

sudo su -c "echo -e 'deb http://http.debian.net/debian sid main contrib non-free' > /etc/apt/sources.list.d/unstable.list"

sudo su -c "echo -e 'deb http://http.debian.net/debian sid main contrib non-free' > /etc/apt/sources.list.d/unstable.list"

4. Update the package lists.

sudo apt-get update

sudo apt-get update

5. Install the selected software.

sudo apt-get install virtualbox/sid linux-headers-$(uname -r)

sudo apt-get install virtualbox/sid linux-headers-$(uname -r)

The procedure is now complete.

6. Undo.

On occasion it is necessary to undo this configuration, for example when upgrading from Debian buster to bullseye. To proceed, run.

sudo rm /etc/apt/sources.list.d/unstable.list

sudo rm /etc/apt/sources.list.d/unstable.list

3. Import Whonix ™ into VirtualBox

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

Start VirtualBox

Click on File then choose Import Appliance...

Navigate and select Whonix ™ image and press next

Do NOT change anything! Just click on Import

Then press Agree

Wait until Whonix ™ .ova has been imported

Now start both Whonix-Gateway ™ and Whonix-Workstation ™

Miscellaneous

There are also Video Tutorials.

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

For command line import instructions, see footnote.

4. Start Whonix ™

Starting Whonix ™ is simple.

Start VirtualBox → Double-click the Whonix-Gateway ™ and Whonix-Workstation ™.