Dev/Build Documentation/14 full
- You need to build on Debian stretch.
- It is recommended to set your terminal (for example Konsole) to unlimited scrollback, so you can watch the full build log.
- You need ~ 30 GB free disk space.
- Short: Don't add private files to Whonix's source code folder! [...]
Long: [...] Unless you know what you are doing. Technically, it would work. This is recommended against. Those files would get managed by the respective package. When you later update Whonix debian packages, your files would get deleted by the package manager. Also adding private files to Whonix's source code folder, later contributing to Whonix's development and accidentally pushing the wrong git branch would be a disaster. Better add your private files to Whonix after building Whonix. Or add a custom build step adding your files, which then get copied from a folder outside of Whonix's source folder.
- Short: Make sure there aren't any VMs in VirtualBox already called Whonix-Gateway or Whonix-Workstation!
Long: Because the build script would fail, because it tries to create VMs either named Whonix-Gateway or Whonix-Workstation.
- Short: Do not try to build Whonix-Gateway and Whonix-Workstation at the same time!
Long: Building Whonix-Gateway and Whonix-Workstation at the same time is not supported due to limitations in the build script. In other words, do not try to run for exampleand at the same time. The build would probably fail.
- Short: Don't use images created inside Continuous Integration (CI) environments for anything besides testing!
Usually you are not using CI environments without knowing.
You can find out if you are running inside a CI environment by running.
If it shows nothing, i.e.
Everything is fine.
Otherwise, if it were to show.
Then don't use these images for anything besides testing.
sudo apt-get update
sudo apt-get install git curl
If you are building behind a Tor transparent proxy such as Whonix-Gateway, you can skip the following steps.
|If you skip these steps of setting up a torified apt-cacher-ng, you must below drop and not use |
|Note, this neither torifies all of the build script's connections nor hides Tor from your ISP!|
Install apt-cacher-ng-, torsocks and tor.
sudo apt-get install apt-cacher-ng torsocks tor
Create folder apt-cacher-ng systemd drop-in folder
sudo mkdir -p /lib/systemd/system/apt-cacher-ng.service.d
Open /lib/systemd/system/apt-cacher-ng.service.d/50_user.conf in an editor with root rights.
[Service] ExecStart=torsocks /usr/sbin/apt-cacher-ng SocketPath=/run/apt-cacher-ng/socket -c /etc/apt-cacher-ng ForeGround=1
sudo systemctl daemon-reload
sudo systemctl apt-cacher-ng restart
Open a terminal (such as Konsole).
The following build targets are available.
--target virtualbox --target qcow2 --target raw --target root
In context of build documentation for the current page you are reading, if you are interested in,
- --target root you should look into our Physical Isolation Build Documentation instead.
- .ova images (most likely for VirtualBox or VMware), then choose --target virtualbox
- .qcow2 images (most likely for KVM or QEMU), then choose --target qcow2
- .raw images (most likely for ports), then choose --target raw
--target virtualbox can be combined with --target qcow2 as well as --target raw, which is useful for redistributable builds. Note, that --target virtualbox is currently the most tested option.
Delete eventually already existing Whonix-Gateway virtual machine. Warning: This will delete a virtual machine named Whonix-Gateway from VirtualBox!
sudo REPO_PROXY=http://127.0.0.1:3142 ~/Whonix/whonix_build --flavor whonix-gateway --target virtualbox --clean
Delete eventually already existing Whonix-Workstation virtual machine. Warning: This will delete a virtual machine named Whonix-Workstation from VirtualBox!
sudo REPO_PROXY=http://127.0.0.1:3142 ~/Whonix/whonix_build --flavor whonix-workstation --target virtualbox --clean
Build a Whonix-Gateway virtual machine image.
sudo REPO_PROXY=http://127.0.0.1:3142 ~/Whonix/whonix_build --flavor whonix-gateway --target virtualbox --build
Build a Whonix-Workstation virtual machine image.
sudo REPO_PROXY=http://127.0.0.1:3142 ~/Whonix/whonix_build --flavor whonix-workstation --target virtualbox --build
The resulting .ova, .qcow2 and/or .raw images can be found in folder.
While building, you might see a few Expected Build Warnings.
Impressum | Datenschutz | Haftungsausschluss
This is a wiki. Want to improve this page? Help is welcome and volunteer contributions are happily considered! See Conditions for Contributions to Whonix, then Edit! IP addresses are scrubbed, but editing over Tor is recommended. Edits are held for moderation.