Manually Creating Whonix
This is just a draft, unfinished! Just some ideas. Unlikely to be ever finished. For special setups and advanced users only. Only in case the Download version, Other Operating Systems, Physical Isolation or Dev/Build Documentation instructions are not suitable, for example if you like to use another distribution as the base for Whonix-Gateway. Dev/Build Anonymity has not been considered.
This assumes Whonix 7 or above.
Dev/Source Code Intro contains a source code introduction.
Look into Whonix source code. It is mostly an installing and copy and paste task.
Look into the source file ./build-steps/45_create-vbox-vm. See function general_setup to see which commands are used to create both Virtual Machines, apply hardware_modifications on both machines, and also apply gateway_specific or workstation_specific accordingly.
After installing the operating system...
- Packages listed in /home/user/Whonix/development/Whonix-Gateway_packages have to be installed on Whonix-Gateway.
- Packages listed in /home/user/Whonix/development/Whonix-Workstation_packages have to be installed on Whonix-Workstation.
All files within whonix_gateway folder are configuration files supposed to be installed on Whonix-Gateway. For example /home/user/Whonix/whonix_gateway/usr/local/etc/torrc.d/50_user.conf is supposed to be installed on Whonix-Gateway under /usr/local/etc/torrc.d/50_user.conf.
All files within whonix_workstation folder are configuration files supposed to be installed on Whonix-Workstation. For example /home/user/Whonix/whonix_workstation/usr/local/bin/xchat-reset is supposed to be copied to /usr/local/bin/xchat-reset on Whonix-Workstation.
whonix_shared are configuration files supposed to be installed on Whonix-Gateway and Whonix-Workstation. For example /home/user/Whonix/whonix_shared/etc/sudoers.d/whonix is supposed to be copied to /etc/sudoers.d/whonix on Whonix-Gateway and Whonix-Workstation.
You don't have to bother with most other files in Whonix source folder. Just read README and LICENSE.
- /whonix_gateway/usr/share/whonix/chroot-scripts-pre.d are run inside Whonix-Gateway
- /whonix_workstation/usr/share/whonix/chroot-scripts-pre.d are run inside Whonix-Workstation
- /whonix_shared/usr/share/whonix/chroot-scripts-pre.d are run inside Whonix-Gateway and Whonix-Workstation
- There are also chroot-scripts-post.d folders.
You can also read the scripts and only run the commands you find sensible manually one by one.
- Those are used for image creation and Virtual Machine creation.
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?)