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


Dev/Building the Whonix-Installer for Windows

< Dev(Redirected from Building the Whonix-Installer for Windows)


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

Compiling the Whonix ™-Windows-Installer yourself[edit]

The following instructions will tell you how to build the Whonix ™-Windows-Installer using the source code provided via Github, as well as the required Whonix ™ and VirtualBox files.

What you'll need[edit]

Preparing the files[edit]

First and foremost, install Inno Setup Unicode on your system.

Now, we may continue by "taking" the VirtualBox-Installer .exe "apart". This is necessary because the .exe actually contains two Microsoft Software Installation (.msi) based Installers, one for x64 and one for x86 systems, as well as a compressed .cab file. To separate these files, we have to run the following command on the command line.

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

Once this has been finished, a window will open telling you where these three files (VirtualBox[Characters based on your version]amd64.msi, VirtualBox[Characters based on your version]x86.msi, have been extracted in. Rename "VirtualBox[Characters based on your version]amd64.msi" to "virtualbox_x64.msi" and "VirtualBox[Characters based on your version]x86.msi" to "virtualbox_x86.msi" and save all of them in a folder, because they will be needed later.

Furthermore, put the Whonix-Workstation ™ and Whonix-Gateway ™ Images in the same folder and rename them "whonix_gateway.ova" and "whonix_workstation.ova" respectively.

Now, put the source files ("Whonix ™.iss", "logo.ico", "license.txt", "MakeInstaller.bat", "config.txt") inside the same folder as the other files. Furthermore, include Whonix ™-Windows-UI ("Whonix ™.exe"), as well as "7zSD.sfx" and "7za.exe".

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

  • Whonix ™.exe
  • virtualbox_x64.msi
  • virtualbox_x86.msi
  • whonix_gateway.ova
  • whonix_workstation.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[edit]

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 "Install Whonix ™.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:

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:

Don't mind having your name connected to Template:Product name? Follow us on Twitter / Facebook.

https | (forcing) onion

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?)

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.