Manually Creating Whonix

From Whonix


Info This information is outdated!

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.

text=Jobs in USA
Jobs in USA

Search engines: YaCy | Qwant | ecosia | MetaGer | peekier | Whonix ™ Wiki

Follow: 1024px-Telegram 2019 Logo.svg.png Iconfinder Apple Mail 2697658.png Twitter.png Facebook.png Rss.png Reddit.jpg 200px-Mastodon Logotype (Simple).svg.png

Support: 1024px-Telegram 2019 Logo.svg.png Discourse logo.png Matrix logo.svg.png

Donate: Donate Bank Wire Paypal Bitcoin accepted here Monero accepted here Contriute

Whonix donate bitcoin.png Monero donate Whonix.png United Federation of Planets 1000px.png

Share: Twitter | Facebook

AppArmor Join us in testing our new AppArmor profiles for improved security! ( forum discussion)

https link onion link

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. Policy of Whonix Website and Whonix Chat and Policy On Nonfreedom Software applies.

Copyright (C) 2012 - 2020 ENCRYPTED SUPPORT LP. Whonix ™ is a trademark. Whonix ™ is a licensee [archive] of the Open Invention Network [archive]. 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 [archive]. Debian is a registered trademark [archive] owned by Software in the Public Interest, Inc [archive].

Whonix ™ is produced independently from the Tor® [archive] anonymity software and carries no guarantee from The Tor Project [archive] 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, Contact.