From Whonix

< Dev


The Whonix ™-Windows-Installer for Windows is a simple and fast way to set-up Whonix ™ on a system running Microsoft Windows.

Download Whonix ™

The Whonix ™ Windows Installer was developed with a focus on providing users with an fast and easy method to install Whonix ™ in Microsoft Windows. This gives users the opportunity to experiment with Whonix ™ in a familiar environment without the necessity of complex virtual machine imports or host operating system changes. When the whonix-installer.exe is executed, the latest VirtualBox version and both Whonix ™ VMs are seamlessly installed on the Windows machine. From there, users can immediately start using Whonix ™ with no further configuration required.[1]


Figure: Run Whonix Installer

Install Whonix.gif

Figure: Install Whonix

Whonix installer wizard.png

Figure: License agreement

Whonix windows installer license agreement.png

Figure: Extracting files

Installing whonix.png

Figure: Whonix installation complete

Whonix setup wizard complete.png

Building the Whonix ™-Windows-Installer from Source Code[edit]


1. The Whonix ™ VirtualBox XFCE ova found here: VirtualBox/XFCE [2]

2. The newest build of the VirtualBox-Installer found here under Windows hosts:

3. 7zSD.sfx which you may obtain under 7-Zip 9.20 Extra here:

You need to download the .7z compressed archive file and extract it.

Figure: Download 7zSD.sfx

  Windows installer 7zSD-sfx.png

4. 7za.exe which you may obtain under 7-Zip 16.04 Extra here:

You need to download the .7z compressed archive file and extract it.

Figure: Download 7za.exe

Windows installer 7za-exe.png

5. The newest version of Inno Setup Unicode, a tool for easily creating installers, found here:

6. Whonix ™-Windows-User-Interface, which can be built from source via this guide: Dev/Whonix ™-Windows-User-Interface

7. The Source for the installer, the logo, the license text, configuration files and the batch file handling the compilation, found here:

Preparing the files[edit]

Note: All commands must be run from the folder containing the corresponding file(s).

1. Install Inno Setup Unicode on your system.

2. The VirtualBox-Installer .exe must be taken "apart". This is necessary because the .exe contains the Microsoft Software Installation (.msi) based Installers for x64 systems, as well as a compressed .cab file.

To separate these files, run the following in the Windows command prompt.

VirtualBox[Characters based on your version].exe -extract

When completed, a window will open with the destination folder the following files (VirtualBox[Characters based on your version]amd64.msi, have been extracted to.

3. Rename VirtualBox[Characters based on your version]amd64.msi to virtualbox_x64.msi.

In the Windows command prompt, run.

move VirtualBox[Characters based on your version]and64.msi virtualbox_x64.msi

All files must be located in the same folder for the Whonix Windows Installer build. Choose a folder and move all files to this folder as preparation continues.

4. Move the Whonix ™ ova image to the folder and rename it to whonix.ova. At time of writing (Aug 09 2019) Whonix- was stable release.

move Whonix-XFCE- C:\path\to\your_build_folder\whonix.ova

5. Move the source files (Whonix.iss, logo.ico, license.txt, MakeInstaller.bat, config.txt) to the build folder.

move <your_source_file> C:\path\to\your_build_folder\

6. Finally, move Whonix ™-Windows-User-Interface (Whonix.exe), 7zSD.sfx and 7za.exe to the build folder.

move <your_file> C:\path\to\your_build_folder\

Now, you should have the following files in the build folder:

  • Whonix.exe
  • virtualbox_x64.msi
  • whonix.ova
  • Whonix.iss
  • logo.ico
  • license.txt
  • 7zSD.sfx
  • 7za.exe
  • MakeInstaller.bat
  • config.txt

With this, the preparation is finished and we can get on to building the Installer.


Building the installer itself is very easy once everything has been properly set up. All you need to do is launch MakeInstaller.bat. Now, the compilation via InnoSetup, the packaging and the combination of all files via 7-Zip, as well as any other required steps are handled automatically. The result is going to be named whonix-installer.exe.

This concludes the guide to building the Whonix ™-Installer for Windows from source.

The deprecated Installer[edit]

There used to a version of this installer based on NSIS which has been discontinued, due to stability and a host of other issues. It may still be found here:


  1. While no further action is required to install or configure the Whonix ™ VMs, it is _possible_ (in some cases) host bios settings or workarounds for VirtualBox bugs will require user intervention. These are not Whonix ™ issues
  2. VirtualBox/CLI is unsupported.

No user support in comments. See Support. Comments will be deleted after some time. Specifically after comments have been addressed in form of wiki enhancements. See Wiki Comments Policy.

Add your comment
Whonix welcomes all comments. If you do not want to be anonymous, register or log in. It is free.

Random News:

Please consider a recurring donation!

https | (forcing) onion

Follow: Twitter | Facebook | | Stay Tuned | Whonix News

Share: Twitter | Facebook

This is a wiki. Want to improve this page? Help is welcome and volunteer contributions are happily considered! Read, understand and agree to Conditions for Contributions to Whonix ™, then Edit! Edits are held for moderation.

Copyright (C) 2012 - 2019 ENCRYPTED SUPPORT LP. Whonix ™ is a trademark. Whonix ™ is a licensee of the Open Invention Network. Unless otherwise noted, the content of this page is copyrighted and licensed under the same Freedom Software license as Whonix ™ itself. (Why?)

Whonix ™ is a derivative of and not affiliated with Debian. Debian is a registered trademark owned by Software in the Public Interest, Inc.

Whonix ™ is produced independently from the Tor® anonymity software and carries no guarantee from The Tor Project about quality, suitability or anything else.

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. Whonix ™ is provided by ENCRYPTED SUPPORT LP. See Imprint.