Build Anonymity

From Whonix
< Dev
(Redirected from Build Anonymity)
Jump to navigation Jump to search

Staying anonymous while building Whonix from source code.

Build Anonymity[edit]

This does only apply, if you are going to build Whonix from source, and/or if you are going to redistribute Whonix and/or if you are going to use Physical Isolation. This is not a Whonix specific problem. Most projects do not even have a chapter about build anonymity. While building Whonix, software has to be downloaded. It is a unique selection of software and there is no way to make it non-unique. Therefore your internet service provider (ISP) could guess, that you are building Whonix. This should not be of any concern in a free country (free by your own definition), if the content of your traffic is not being observed or logged.

Especially, but not exclusively, in case you want to redistribute Whonix, you might be interested to hide the fact, you are building Whonix (i.e. you want to stay anonymous).

To prevent any kind of personally identifiable or even fingerprintable information leaking from the build system into the Whonix images, it is recommended to build inside of an already torified Virtual Machine. [1] [2] You can build Whonix inside an existing Whonix-Workstation, but it can also be built on a headless server.

It is also recommended to build in an already torified Virtual Machine, because that prevents leaks from the build system, which could help an attacker (with root access to the Whonix-Workstation), to gather identifiable information about that build system, that could ultimately lead back to your identity.

Beginning with Whonix 0.4.0, grml-debootstrap and chroot is being used for virtual machine image creation. The grml-debootstrap source code tells, that it copies /etc/network/interfaces and /etc/resolv.conf into the chroot. grml-debootstrap also mounts a lot devices (/dev, /proc etc.) inside the chroot and later Whonix chroot also mounts some devices. That's why it is recommended to build inside an already torified virtual machine.

Building from source code naturally also leaves local traces on the disk, such as the source code itself and build dependencies. If that is of concern to you, it can be more easily disposed, when it is contained in a Virtual Machine.

It would also be possible to build directly on the host and torify all connections the scripts make, but it is unknown what other grml-debootstrap/chroot related leaks there might be.

It is a known issue the build anonymity requires building inside a VM.

VirtualBox inside VirtualBox[edit]

See Nested Virtualization.


corridor, a Tor traffic whitelisting might be useful. See also discussion on the tor-talk mailing


  1. Yes, this creates a bootstrap, chicken or egg problem. To solve it you can either download already existing Whonix binary builds or if you prefer to build from source, build a minimal torified machine yourself first while running any network traffic over Tor. Any help required with that? Contact us. See also Manually Creating Whonix.
  2. Whonix build process attempts to not leak anything (such as /etc/resolv.conf) from the host system into the VM image since that would also a bug hindering the implementation of reproducible However, in software nothing can be guaranteed with absolute certainty. By using a VM, this risk is minimized.

We believe security software like Whonix needs to remain open source and independent. Would you help sustain and grow the project? Learn more about our 12 year success story and maybe DONATE!