tor-webwml.git

@@ -7,24 +7,30 @@

 <!-- PUT CONTENT AFTER THIS TAG -->

-<h2>Tor VM</h2>

-<hr>

+<h1>Tor VM</h1>

-<h3>What Is It?</h3>

-<p>Tor VM is a transparent Tor proxy for Windows that uses Qemu full

+<h2>What Is It?</h2>

+<p>Tor VM is an experimental transparent Tor proxy for Windows that uses Qemu

 virtualization technology for more resilient Tor clients and relays.

 </p>

-<p><strong>The initial 0.0.1 release is a work in progress!</strong>

+<p><strong>This initial 0.0.1 release is a work in progress!</strong>

 See the

 <a href="http://bugs.noreply.org/flyspray/index.php?tasks=all&amp;project=4&amp;cat=19"

 >bug tracking database for known issues</a>. Remember to backup anything

 important before using this software on your system.</p>

+

+<hr />

 <a id="Download"></a>

-<h3><a class="anchor" href="#Download">Download Tor VM Software</a></h3>

+<h2><a class="anchor" href="#Download">Step One: Download Tor VM Software</a></h2>

-<ul>

+<p>The bundle packages are preferred since they include Vidalia and other Tor

+software that improves the user experience. If a portable Tor VM instance is

+required then the self extracting archive can be used to install Tor VM alone

+onto a portable storage device and run wheverever administrator rights are

+available to you.</p>

+<ul>

 <li><a href="dist/TorVM-0.0.1-NetInstaller.exe">Tor VM Network Installer</a>

 (<a href="dist/TorVM-0.0.1-NetInstaller.exe.asc" style="font-size: 90%;">sig</a>)</li>

@@ -33,11 +39,11 @@ important before using this software on your system.</p>

 <li><a href="dist/Tor_VM.exe">Tor VM Portable Self Extractor</a>

 (<a href="dist/Tor_VM.exe.asc" style="font-size: 90%;">sig</a>)</li>

-

 </ul>

+<hr />

 <a id="Setup"></a>

-<h3><a class="anchor" href="#Setup">Configure Windows For Less Risk</a></h3>

+<h2><a class="anchor" href="#Setup">Step Two: Configure Windows For Less Risk</a></h2>

 <p>Running Firefox with Torbutton as a reduced privilege user provides

 defense in depth against various risks Internet users face. These steps

@@ -82,8 +88,10 @@ while Firefox and other Internet applications run with restricted rights.</p>

 <p><img src="img/uc09.png" alt="Both Tor VM admin and restricted user can be used concurrently" /></p>

-<a id="Install"></a>

-<h3><a class="anchor" href="#InstallExtractor">Tor VM Self-Extractor</a></h3>

+

+<hr />

+<a id="InstallExtractor"></a>

+<h2><a class="anchor" href="#InstallExtractor">Step Three: Tor VM Self-Extractor</a></h2>

 <p>Save the installer executable to Desktop or portable storage.</p>

@@ -97,9 +105,16 @@ while Firefox and other Internet applications run with restricted rights.</p>

 <p><img src="img/extr03.png" alt="Run the torvm.exe program in the Tor_VM folder" /></p>

-<h3><a class="anchor" href="#InstallBundle">Install Tor VM Bundle</a></h3>

+<h2><a class="anchor" href="#Run">Proceed to: Run Tor VM</a></h2>

-<p>Double click on the Bundle or Network Installer EXE to begin installation.</p>

+

+<hr />

+<a id="InstallBundle"></a>

+<h2><a class="anchor" href="#InstallBundle">Step Three: Install Tor VM Bundle</a></h2>

+

+<p>The bundle installers include Vidalia and other software for the local

+machine instead of a portable folder. Double click on the Bundle or

+Network Installer EXE to begin installation to the current system.</p>

 <p><img src="img/bundle01.png" alt="Click to Run Bundle Installer" /> &nbsp;

 <img src="img/netinst01.png" alt="Click to Run Network Installer" /></p>

@@ -114,8 +129,10 @@ to reliably download all of the latest bundle application packages on demand.</p

 <p><img src="img/netinst02.png" alt="Network Installer downloads bundle software on demand" /></p>

+

+<hr />

 <a id="Run"></a>

-<h3><a class="anchor" href="#Run">Run Tor VM and Vidalia</a></h3>

+<h2><a class="anchor" href="#Run">Step Four: Run Tor VM</a></h2>

 <p>After installing the bundle packages a Tor VM controller is started in

 the background. The installer program has finished and can be closed.</p>

@@ -133,6 +150,11 @@ through the network.</p>

 <p><img src="img/run03.png" alt="Bootstrap not complete until circuit created" /></p>

+<p>If you are running the Tor VM bundle Vidalia will also display the current

+progress while bootstrapping into the Tor network.</p>

+

+<p><img src="img/vidalia-bootstrap.png" alt="Vidalia will also show bootstrap status" /></p>

+

 <p>After successful start a list of transparent proxy connection counts are

 shown. This indicates that Tor VM is up and ready to start transparently

 routing traffic through the Tor network. The socks port is also available to

@@ -152,26 +174,136 @@ with the generated image tiles already included.</p>

 which may resolve the problem.</p>

 -->

-<a id="Repair"></a>

-<h3><a class="anchor" href="#Repair">Repair Installed Applications</a></h3>

-<p><img src="img/vidalia-support.png" alt="In Add or Remove Programs - Select support option for package" /></p>

+<hr />

+<a id="RecommendedUse"></a>

+<h2><a class="anchor" href="#RecommendedUse">Step Five: Using Firefox and TorButton</a></h2>

-<p>Choose the repair option and all of the package files and registry will be

-restored.</p>

+<p>You should run Firefox and other Internet software as a restricted user.

+Switch to the restricted user account configured in <a class="anchor" href="#Setup">Step Two</a>.</p>

-<p><img src="img/vidalia-repair.png" alt="Choose Repair option" /></p>

+<p>Press The Windows Key + L to switch users, or select the "Log off"

+Start Menu option followed by "Switch User"</p>

+

+<p><img src="img/" alt="" /></p>

+

+<p>Click the "Install TorButton" shortcut if you do not have the Tor Button

+plugin installed.</p>

+

+<p><img src="img/torbutton01.png" alt="" /></p>

+

+<p>Continue with installation despite warning about installing from local file.</p>

+

+<p><img src="img/torbutton02.png" alt="" /></p>

+

+<p>You will need to restart Firefox to use the new TorButton extension.</p>

+

+<p><img src="img/torbutton03.png" alt="" /></p>

+

+<p>Click on the TorButton status icon in the lower right to enable Tor.</p>

+

+<p><img src="img/torbutton04.png" alt="" /></p>

+

+<p>Verify that you are using Tor via

+<a href="https://check.torproject.org/">https://check.torproject.org/</a></p>

+

+<p><img src="img/torbutton05.png" alt="" /></p>

+

+

+<hr />

+<a id="ExperimentalUse"></a> 

+<h2><a class="anchor" href="#ExperimentalUse">Experimental: Using Flash</a></h2>

+

+<p><strong>IMPORTANT: Tor VM can protect your endpoint IP address when using

+Flash and other software but it does not yet protect against attacks which

+reduce your anonymity set.</strong> DO NOT use Tor VM in this manner if you

+rely on unlinkable anonymity; wait until this is addressed in future releases.

+</p>

+

+<p>You should run Flash Player and other Internet software as a restricted user.

+Switch to the restricted user account configured in <a class="anchor" href="#Setup">Step Two</a>.</p>

+

+<p><img src="img/switch-user.png" alt="Switch to restricted user to play Flash content" /></p>

+

+<p>First be sure that transparent proxy of Internet traffic through Tor is

+working correctly. Tor VM ensures that all your traffic is anonymized

+regardless of whether TorButton and Firefox are used or not.</p>

+<p><img src="img/flash01.png" alt="" /></p>

+

+<p>Connections made from the Browser and Flash Player plugin will now

+be transparently proxied through the Tor network when viewing content.</p>

+

+<p><img src="img/flash02.png" alt="" /></p>

+

+<p>The transparent proxy redirection counts will indicate connections redirected

+through Tor in this manner. Traffic sent via TorButton and Polipo are visible as

+SOCKS connections to the Tor VM instance.</p>

+

+<p><img src="img/transparent.png" alt="Transparent proxy traffic can be seen along with TorButton and Polipo traffic" /></p>

+

+

+<hr />

+<a id="Modify"></a>

+<h2><a class="anchor" href="#Modify">Modify Tor VM Install Options</a></h2>

+

+<p>Once a package is installed you can change the default installation options

+via the "Change" option for the package. For example, Tor VM is configured to

+run at start up which can be disabled by modifying the installation.</p>

+

+<p><img src="img/change01.png" alt="" /></p>

+ 

+<p>The Change package option will launch the installer GUI for the package.</p>

+

+<p><img src="img/change02.png" alt="" /></p>

+ 

+<p>The list of configurable installation options can now be set as desired.

+For example, disabling the "Run at Startup" option as shown here.</p>

+

+<p><img src="img/change03.png" alt="" /></p>

+ 

+<p>Select "Next" once all changes have been selected.</p>

+

+<p><img src="img/change04.png" alt="" /></p>

+ 

+<p>Select "Change" to apply the changes to the installed software.</p>

+

+<p><img src="img/change05.png" alt="" /></p>

+ 

+<p>And finally "Finish" to exit the installer GUI. The requested changes

+are now in effect.</p>

+

+<p><img src="img/change06.png" alt="" /></p>

+ 

+

+<hr />

 <a id="Remove"></a>

-<h3><a class="anchor" href="#Remove">Uninstall Tor Bundle Software</a></h3>

+<h2><a class="anchor" href="#Remove">Uninstall Tor Bundle Software</a></h2>

 <p>A script to uninstall all of the Tor bundle applications at once is placed

 on the desktop. Run this utility to remove all of the Tor packages and files.</p>

 <p><img src="img/uninstall.png" alt="The Uninstall_Tor script will remove all Tor packages and files" /></p>

+

+<hr />

+<a id="Repair"></a>

+<h2><a class="anchor" href="#Repair">Repair Installed Applications</a></h2>

+

+<p>If any installed files become corrupted or deleted you can repair them

+with the support option for the application package having problems.</p>

+

+<p><img src="img/vidalia-support.png" alt="In Add or Remove Programs - Select support option for package" /></p>

+

+<p>Choose the repair option and all of the package files and registry will be

+restored.</p>

+

+<p><img src="img/vidalia-repair.png" alt="Choose Repair option" /></p>

+

+

+<hr />

 <a id="Debug"></a>

-<h3><a class="anchor" href="#Debug">Troubleshoot Problems and Report Bugs</a></h3>

+<h2><a class="anchor" href="#Debug">Troubleshoot Problems and Report Bugs</a></h2>

 <p>The Tor VM category in the Tor flyspray bug tracker is used to manage

 defects and features. See the

@@ -180,11 +312,13 @@ defects and features. See the

 <!-- localized installers and full Marble data bundle?

 <a id="Advanced"></a>

-<h3><a class="anchor" href="#Advanced">Experimental Packages and Usage</a></h3>

+<h2><a class="anchor" href="#Advanced">Experimental Packages and Usage</a></h2>

 -->

+

+<hr />

 <a id="More"></a>

-<h3><a class="anchor" href="#More">Additional Resources</a></h3>

+<h2><a class="anchor" href="#More">Additional Resources</a></h2>

 <p>The latest design document for Tor VM is available in revision control:

 <a href="https://svn.torproject.org/svn/torvm/trunk/doc/design.html"