torvm/en/index.wml (6193f9316) - tor-webwml.git

index.wml

## translation metadata
# Revision: $Revision$

#include "head.wmi" TITLE="Tor VM"

<h3>What Is It?</h3>
<p>Tor VM is a transparent Tor proxy for Windows that uses Qemu full
virtualization technology for more resilient Tor clients and relays.
</p>
<p><strong>The 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>

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

<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>/
<a href="dist/TorVM-0.0.1-NetInstaller.exe.sha1.txt" style="font-size: 90%;">sha1</a>)</li>

<li><a href="dist/TorVM-0.0.1-Bundle.exe">Tor VM Bundle Installer</a>
(<a href="dist/TorVM-0.0.1-Bundle.exe.asc" style="font-size: 90%;">sig</a>/
<a href="dist/TorVM-0.0.1-Bundle.exe.sha1.txt" style="font-size: 90%;">sha1</a>)</li>

<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>/
<a href="dist/Tor_VM.exe.sha1.txt" style="font-size: 90%;">sha1</a>)</li>

</ul>

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

<p>Running Firefox with Torbutton as a reduced privilege user provides
defense in depth against various risks Internet users face. These steps
explain how to create a restricted account for user name "anon".</p>

<p>Navigate to the control panel "User Accounts" option. You can also use
the menu navigation:<br />

<strong>Start Menu -&gt; Settings -&gt; Control Panel -&gt; Add or Remove Programs</strong></p>

<p>Select "Create a new account".</p>

<p>Provide a nickname for the anonymous limited user account.</p>

<p>Choose the "Limited" account type for the reduced privilege user feature.</p>

<p>Select "Create Account".</p>

<p>The new user is added to the list of accounts on the local system. This is
the account that Internet applications like Firefox will run as when using
Tor VM to route traffic through the Tor network.
</p>

<p>The Switch User feature is used to run critical Tor VM software as Admin
while Firefox and other Internet applications run with restricted rights.</p>

<p>The new limited user desktop has its own configuration and environment.</p>

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

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

<p>Select the path or folder to extract into.</p>

<p>Run the torvm.exe program in the extracted Tor_VM folder.</p>

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

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

<p>The bundle package installs each of the applications included with Tor VM like 
Vidalia and Tor Button.</p>

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

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

<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>

<p>After preparing network devices a Qemu virtual machine running the
Tor VM kernel is launched. A status screen will be shown detailing progress
bootstrapping the Tor software into the network.</p>

<p>The bootstrap is 100% complete when Tor is able to create a circuit
through the network.</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
the host for use with Polipo or Privoxy http proxies.</p>

<!-- no marble for first release
<p>The first time Vidalia is run the image tiles needed for the Marble Map
plugin will be generated at start. If you do not have sufficient memory or
CPU to generate these tiles you can install the full Vidalia Marble package
with the generated image tiles already included.</p>

<p>If any of the bundle applications stop working a repair can be requested
which may resolve the problem.</p>
-->

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

<p>Choose the repair option and all of the package files and registry will be
restored.</p>

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

<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>

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

<p>The Tor VM category in the Tor flyspray bug tracker is used to manage
defects and features. See the
<a href="http://bugs.noreply.org/flyspray/index.php?tasks=all&amp;project=4"
>Tor flyspray bug tracker</a> for known issues and pending changes.</p>

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

<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"
>https://svn.torproject.org/svn/torvm/trunk/doc/design.html</a>.
</p>

<p>Features and fixes planned for the Tor VM software are documented in the
<a href="https://svn.torproject.org/svn/torvm/trunk/TODO">Tor VM TODO</a>.</p>

<p><a href="https://data.peertech.org/torbld/info/Tor_VM-svn">Automated package
builds are available</a> for verifying fixes in subversion and testing work in
progress.</p>

<p>Be sure to build against a known working tag in the torvm repo. For
example,<br />
svn export https://svn.torproject.org/svn/torvm/tags/torvm-0_0_1 torvm-0.0.1-src
</p>

</div>

#include <foot.wmi>

tor-webwml.git

Add network installer graphic and description.