Tor VM

What Is It?

Tor VM is a transparent Tor proxy for Windows built with Qemu virtualization technology for more resilient clients and relays.

You can think of Tor VM like a Tor virtual network card that routes all of the traffic from your machine transparently over the Tor network without application proxy settings or other configuration.

The Tor VM design document contains additional detail about this work in progress.


Step One: Download Tor VM Software


Step Two: Install Tor VM

Double click on the Bundle or Network Installer EXE to begin installation to the current system.

Click to Run Bundle Installer

The network installer contains the secure Tor updater software that is used to reliably download all of the latest bundle application packages on demand.

Network Installer downloads bundle software on demand


Step Three: Run Tor VM

When installation is complete a Tor VM controller is started in the background. The installer program has finished and can be closed.

Tor VM controller will start at end of install

After preparing network devices a Qemu virtual machine running the Tor VM kernel is launched with the Vidalia controller. It may take a few minutes to bootstrap into the Tor network. Please be patient.

Bootstrap not complete until circuit created


Step Four: Using Firefox and Torbutton

Once Tor has successfully built a circuit the Switch User menu is presented. Firefox and other Tor applications must be run with the "Tor" restricted user account.

Switch to Tor restricted user account

Start Firefox and click on the Torbutton status icon in the lower right to enable Tor.

Click on Torbutton status icon to toggle ON

Verify that you are using Tor via https://check.torproject.org/

Verify Tor use at check.torproject.org


Experimental: Using Flash

IMPORTANT: This is not a recommended use of Tor.

Right click on Torbutton icon at lower right for menu. Select "Preferences..." option.

Select Torbutton Preferences menu option

Toggle the "Disable plugins..." dynamic content security setting.

Toggle disable plugins dynamic content security setting

Connections made from the Browser and Flash Player plugin will now be transparently proxied through the Tor network when viewing content.

Flash player and other software now using Tor


Step Five: Shutdown Tor VM

Press The Windows Key + L to switch back to administrator User.

Windows Key + L to switch user

Switch back to admin user account

Select the Vidalia "Exit" option to shutdown the VM and restore network settings. The restricted Tor user will be logged off automatically.

Select Vidalia Exit option to close VM

Do not close the Tor VM controller window while restoring network settings.

Do not close the Tor VM window while restoring network settings


Uninstall Tor Bundle Software

A script to uninstall all of the Tor bundle applications is placed on the desktop. Run this utility to remove all of the Tor software and files.

The Uninstall_Tor script will remove all Tor packages and files


Troubleshoot Problems and Report Bugs

The Tor VM category in the Tor flyspray bug tracker is used to manage defects and features. See the Tor flyspray bug tracker for known issues and pending changes.

Features and fixes planned for the Tor VM software are documented in the Tor VM TODO.


"Tor" and the "Onion Logo" are registered trademarks of The Tor Project, Inc.
Content on this site is licensed under a Creative Commons Attribution 3.0 United States License, unless otherwise noted.

This page is also available in the following languages: français, polski, Русский (Russkij), 中文(简) (Simplified Chinese).
How to set the default document language.

Contact Us - Last modified: Wed Jan 27 14:53:07 2010 - Last compiled: Wed Sep 1 08:34:40 2010