Jump to: navigation, search


About this Ubuntu Page
Support Status unmaintained
Difficulty medium
Maintainer none
Support Support

Most simple, least secure[edit]


Unofficial Video, using Whonix-Gateway to torify Ubuntu.

Html5 Video. Works without Flash inside Tor Browser. Showing the Easiest, but least secure option, see Youtube Link.

More secure[edit]

Tested with Debian and Ubuntu.

Download Ubuntu (or use a different install CD or iso file) and verify using VerifyIsoHowto.

Create a new VM and choose following settings: Under Network set Adapter 1 to "Internal Network", rename "intnet" to "Whonix".

You can use the Live environment or install Ubuntu. When the installer asks questions, generally choose the default, most common or other non-identifying options. Language: English; keymap: choose yours (potentially risk...); Country (leave it as it is): United States (New York for Ubuntu 14.04); User Name: leave blank; Host Name: host ; Time Zone (change it): UTC (it's at the very bottom. For Ubuntu 14.04 change it later using tzdata as instructed below); Username (account name): user. This ensures that all Whonix users have the same settings. Additionally this is more safe, when an application leaks such data, such as SSH, if you simply ssh some.host.name, it will tell your current account name, and it would be very bad if this where you real name or anything which would identify you.

Reboot into the freshly installed system and open a terminal.

If you forgot to set the time to UTC you can do so at any time by typing the following into the terminal:

sudo dpkg-reconfigure tzdata

Remove Ubuntu's “phone home” program(s). If any of these packages are not installed the error message should indicate which to delete from the command. In a terminal type:

sudo apt-get -y remove canonical-census unity-lens-shopping unity-scope-video-remote unity-scope-musicstores

Dhcp auto-configuration like software such as network manager have to be removed, since we are using static networking.

sudo apt-get remove isc-dhcp-client isc-dhcp-common network-manager network-manager-gnome resolvconf

Setup a fixed IP for the virtual LAN network card and to use the same subnet like the Whonix-Gateway for the Internal Network. If you use a Linux desktop with network manager you can use the GUI for this step. Otherwise: open a Terminal and type

Open /etc/network/interfaces in an editor with root rights.

If you are using a graphical Whonix or Qubes-Whonix, run:

kdesudo kwrite /etc/network/interfaces

If you are using a terminal-only Whonix, run:

sudo nano /etc/network/interfaces

You only need to configure eth0:

# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface, leave as it is
auto lo
iface lo inet loopback

auto eth0
#iface eth0 inet dhcp
iface eth0 inet static
# increment last octet on additional workstations

Open /etc/resolv.conf.

Open /etc/resolv.conf in an editor with root rights.

If you are using a graphical Whonix or Qubes-Whonix, run:

kdesudo kwrite /etc/resolv.conf

If you are using a terminal-only Whonix, run:

sudo nano /etc/resolv.conf

For auto-generated resolv.conf files, do this instead:

Open /etc/resolvconf/resolv.conf.d/base in an editor with root rights.

If you are using a graphical Whonix or Qubes-Whonix, run:

kdesudo kwrite /etc/resolvconf/resolv.conf.d/base

If you are using a terminal-only Whonix, run:

sudo nano /etc/resolvconf/resolv.conf.d/base

and delete everything, then add


Update package lists.

sudo apt-get update

Get latest updates.

sudo apt-get dist-upgrade

Guest additions for Ubuntu[edit]

You can try first, if VirtualBox Guest Additions work on Ubuntu, because they are a bit shorter and easier.


On the host:

sudo apt-get install virtualbox-guest-additions-iso

Inside Whonix-Workstation:

Execute the following commands. They can take a very long time, due to the Ubuntu upstream bug.[1]

sudo apt-get update
sudo apt-get dist-upgrade
sudo apt-get install dkms build-essential linux-headers-generic linux-headers-generic-pae

Insert the guest additions iso by clicking on the VM -> devices -> install guest additions.

sudo mkdir -p /mnt/sr0
sudo mount /dev/sr0 /mnt/sr0
sudo sh /mnt/sr0/VBoxLinuxAdditions.run

Or start autorun.sh (not with a console, strange bug!).

Force remove CD eject.

Reboot. Done.


About Ubuntu[edit]

TODO: This chapter needs revision. Incorporate latest developments: Privacy in Ubuntu 12.10: Amazon Ads and Data Leaks

While Ubuntu is one of the more secure (See Overview) Linux distributions it's by no means a secure operating system. It is designed first and foremost to bring Linux to end users. It doesn't protect against some of the threat models that some Tor users will have.

Here's an (incomplete) list of things the more paranoid user will have to consider:

apt-get as currently used in Ubuntu does not protect against a stale mirror attack (Bug #716535: Please support Valid-Until in release files for security.ubuntu.com) where an adversary provides validly signed but outdated metadata to prevent users from downloading and installing the latest critical security updates. When fetching updates over tor this problem is of a lesser extent because no single malicious exit relay will realistically prevent users from downloading updates more than once in a row. Malicious mirror is possible but Whonix-Workstation uses the main US mirror, any irregularities will be uncovered pretty soon. More of concern is the clear text update of the host operating system. Here it's a good idea to manually check how old the repository metadata is yourself:

find /var/lib/apt/lists/* -type f | xargs cat | grep "Date: "

From time to time vulnerabilities that allow installation of untrusted code are discovered in apt. New security features are often implemented in Debian first.

The Ubuntu server kernel comes with everything and the kitchen sink. At any given day the kernel will be vulnerable in one way or the other. It's by far the most patched piece of code in the default Ubuntu Server installation, obviously runs at full kernel privileges and naturally can't be protected with mandatory access control. Whonix-Gateway exposes the kernel to attacks through its firewall, TCP/IP stack and whatever kernel calls Tor does or could be compelled to do.

checksec.sh --kernel reports good kernel protection: GCC stack protector support, Enforce read-only kernel data, Restrict /dev/mem and /dev/kmem access are all enabled!

Userland protection for Tor is great. [2] Unlike TBB bundles the tor version distributed via the .deb comes with RELRO, canaries etc. and can fully make use of ASLR since it's compiled as PIE. Of course with Grsec the entropy would be higher.


  1. Unpacking linux-headers unbelievably slow in Lubuntu Precise (Beta 1) (Affects Ubuntu precise final as well.)
  2. This would only apply if you created a Custom-Whonix-Gateway.

Random News:

Please help in testing new features and bug fixes in Whonix.

Impressum | Datenschutz | Haftungsausschluss

https | (forcing) onion
Share: Twitter | Facebook | Google+
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. Whonix (g+) is a licensee of the Open Invention Network. Unless otherwise noted above, the content of this page is copyrighted and licensed under the same Free (as in speech) license as Whonix itself.