Manually Creating Whonix

From 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.[1] Just read README and LICENSE.

Chroot Scripts...

  • /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.

See Also[edit]


  1. 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.

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

Random News:

Want to make Whonix safer and more usable? We're looking for helping hands. Check out the Open Issues and development forum.

https | (forcing) onion

Follow: Twitter | Facebook | | Stay Tuned | Whonix News

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

Whonix ™ is a derivative of and not affiliated with Debian. Debian is a registered trademark owned by Software in the Public Interest, Inc.

Whonix ™ is produced independently from the Tor® anonymity software and carries no guarantee from The Tor Project about quality, suitability or anything else.

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.