# Introduction

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

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]

# Screenshots

Figure: Run Whonix Installer

Figure: Install Whonix

Figure: Extracting files

Figure: Whonix installation complete

# Building the Whonix ™-Windows-Installer from Source Code

## Requirements

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

2. The newest build of the VirtualBox-Installer found here under Windows hosts: https://www.virtualbox.org/wiki/Downloads?replytocom=98578

3. 7zSD.sfx which you may obtain under 7-Zip 9.20 Extra here: http://www.7-zip.org/download.html

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





4. 7za.exe which you may obtain under 7-Zip 16.04 Extra here: http://www.7-zip.org/download.html

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


5. The newest version of Inno Setup Unicode, a tool for easily creating installers, found here: http://www.jrsoftware.org/isdl.php

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: https://github.com/Whonix/Whonix-Windows-Installer

## Preparing the files

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, common.cab) 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-15.0.0.3.3 was stable release.

move Whonix-XFCE-15.0.0.3.3.ova 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
• common.cab
• 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

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

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: https://github.com/Whonix/Whonix-Windows-Installer-deprecated

# Footnotes

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

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.

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

Random News:

https | (forcing) onion

Follow: Twitter | Facebook | gab.ai | Stay Tuned | Whonix News