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
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
- The Whonix-Gateway ™ and Whonix-Workstation ™ Images for VirtualBox found here: https://www.whonix.org/wiki/VirtualBox
- The newest build of the VirtualBox-Installer found here under "Windows hosts": https://www.virtualbox.org/wiki/Downloads?replytocom=98578
- "7zSD.sfx" which you may obtain under "7-Zip 9.20 Extra" here: http://www.7-zip.org/download.html
- "7za.exe" which you may obtain under "7-Zip 16.04 Extra" here: http://www.7-zip.org/download.html
- The newest version of Inno Setup Unicode, a tool for easily creating installers, found here: http://www.jrsoftware.org/isdl.php
- Whonix ™-Windows-UI, which can be built from source via this guide: Dev/Building Whonix ™-UI for Windows
- 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
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, common.cab) 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
- Whonix ™.iss
With this, the preparation is finished and we can get on to building the Installer.
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 "Install Whonix ™.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
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.
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?)