Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

= Notice =

This version of the installer is deprecated and unsupported. For the current version, please visit:

= Introduction =

The Whonix-Installer for Windows is a simple and fast way to set-up Whonix on a system running Microsoft Windows. The following instructions will tell you how to build the Whonix-Installer for Windows using the source code provided via Github, as well as base Whonix and VirtualBox files.

= What you'll need =

= Preparing the files =

We start 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 seperate 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.

Next up, put 7za.exe in the same folder and execute the following two commands in this directory:

7za a gateway.7z whonix_gateway.ova
7za a workstation.7z whonix_workstation.ova

Now you have two highly compressed 7zip files, "gateway.7z" and "workstation.7z". This is done to make the Installer as compact as is possible.

You may now remove the .ova files from the folder as they won't be needed anymore.

Now, put the source files (Whonix.nsi, logo.png, license.rtf) inside the same folder as the other files. Furthremore, include Whonix-UI (Whonix.exe).

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

  • Whonix.exe
  • 7za.exe
  • virtualbox_x64.msi
  • virtualbox_x86.msi
  • gateway.7z
  • workstation.7z
  • Whonix.nsi
  • logo.ico
  • license.rtf

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

= Building the Installer =

If you recall, at the beginning I mentioned that NSISBI would be necessary. Run "makensisw" from the version of NSISBI you've obtained. Click on "File -> Load Script...", navigate to the folder you've saved the prior files in and select Whonix.nsi. This should start building the Installer. The Output can be found in the folder you've stored all the other files in named "Whonix-Installer.exe".

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


The intial version of a simple, Installer for Whonix, Whonix-UI and accompanying software. Based on NSIS and 7-Zip, not maintained.



MIT, Unknown licenses found

Licenses found






No releases published


No packages published