Multiple Whonix-Gateway ™

From Whonix
(Redirected from Multiple Whonix-Gateways)
Jump to navigation Jump to search



Info Note: It is far safer and easier to manage multiple Whonix-Gateway ™ when only one is launched for user activities, rather than running many in parallel.

Multiple Whonix-Gateway ™ can be used alongside multiple Whonix-Workstation ™, but this has both advantages and disadvantages. One security benefit is the isolation of separate Whonix-Gateway ™ VM instances. In the event that one Whonix-Gateway ™ is compromised, it is not certain the other(s) will be similarly compromised. On the downside, newly cloned Whonix-Gateway ™(s) will end up with a different set of Tor entry guards unless precautions are taken. [1] [2]

In this configuration ISPs are probably capable of detecting that two different Tor data folders are in use, but this is not necessarily an anonymity threat. Similarly, if multiple Tor Browsers are used with distinct Whonix-Gateway ™, then a different set of Tor entry guards will be used as well (unless by chance the same Tor guards are chosen for different Whonix-Gateway ™).

When multiple Whonix-Gateway ™ are run in parallel, the risks explained in the Multiple Whonix-Workstation ™: Safety Precautions section equally apply.

Non-Qubes-Whonix ™[edit]

Info Note: These instructions only apply to Download/Default-Whonix-Workstation ™.

Non-Qubes-Whonix ™ means all Whonix ™ platforms except Qubes-Whonix ™. This includes Whonix ™ KVM, Whonix ™ VirtualBox and Whonix ™ Physical Isolation.


In this configuration, Whonix-Workstation ™ will not be able to communicate with one another. This is recommended to keep different Tor activity profiles completely separate. To run multiple Whonix-Gateway ™ it is necessary to clone existing VMs; the steps below assume an existing Whonix ™ install.

1. Create clones of the Gateway and Workstation VMs rolled back to clean snapshots.

In Virtual Machine Manager: Highlight VMOpenVirtual MachineClone...Clone

2. Export Whonix ™ internal network settings.

sudo virsh net-dumpxml Whonix-Internal > Whonix-Internal2.xml

3. Edit the network configuration to make it unique.

  • Change the name and bridge name.
  • Delete the mac address and uuid parameters.

Alternatively, replace the configuration with the example below (this assumes the only custom networks are Whonix ™-related).

  <bridge name='virbr3' stp='on' delay='0'/>

Save and exit.



  • virbr1 is assigned to the Whonix-External network (default Whonix-Gateway ™ external NAT NIC); and
  • virbr2 is assigned to the Whonix-Internal network (default Whonix-Workstation ™ internal NIC).

Therefore, the network name was changed to internal2 and the bridge name to virbr3.

4. Import and start the new network.

virsh -c qemu:///system net-define Whonix-Internal2.xml
virsh -c qemu:///system net-autostart Whonix-Internal2
virsh -c qemu:///system net-start Whonix-Internal2

5. Attach the Gateway and Workstation VM NICs to the new network.

Ensure that one Gateway NIC is attached to the external network. It is important to carefully match internal network interfaces to the new ones and not accidentally switch to a NIC that connects outside.

To edit the VM virtual NIC settings:
Highlight VMOpenSettingsNIC virtual hardware → Set Network Source to: Virtual network 'Whonix-Internal2' : Isolated network, internal and host routing only

Note that the network is exclusively internal and does not communicate with the host in any way.

6. Change the number of pinned CPUs.

It is recommended to edit the cloned workstation's configuration and change the number of pinned CPUs to a different value (3 or 4) compared to the existing gateway and primary workstation. This only works if users have a quad-core system.


In VirtualBox Manager, it is necessary to change the name of the internal network for both Whonix-Gateway ™ and Whonix-Workstation ™.

1. Learn the default Whonix ™ internal network name.

It is Whonix.

2. Pick an alternative internal network name.

For the second, third or nth multiple Whonix-Gateway ™ another internal network name is required. Any name can be used, but make sure it is not re-used in any other Whonix-Gateway ™ which should be isolated from this one. The following example will use Whonix2, however it could be something completely different like for-my-onion-web-server.

3. Change Whonix-Gateway ™ internal network name.

  • VirtualBox → Whonix-Gateway ™ → SettingsNetworkAdapter 2Name: → change Whonix to something else such as Whonix2OK

4. Change Whonix-Workstation ™ internal network name.

  • VirtualBox → Whonix-Workstation ™ → SettingsNetworkAdapter 1Name: → change Whonix to the same internal network name as above → OK

Qubes-Whonix ™[edit]

It is simple to create additional Whonix-Gateway ™ (sys-whonix instances) in Qubes-Whonix ™; see Create Gateway ProxyVMs.

The only requirement is that the newly created sys-whonix is based on the whonix-gw-16 Template and has a distinctive VM name, so it is not confused with other VMs.

See Also[edit]


  1. Such as manually configuring identical Tor entry guards. Qube-Whonix ™ users can copy the Tor state folder to another instance or use Bridges.
  2. At present, full instructions are not available for every Non-Qubes-Whonix platform.