tor-webwml.git

1) ## translation metadata

2) # Revision: $Revision$

3) # Translation-Priority: 4-optional
4) 
5) #include "head.wmi" TITLE="Tor VM" CHARSET="UTF-8"
6) 
7) <div id="content" class="clearfix">
8) 	<div id="breadcrumbs">

9)     <a href="<page index>">Home &raquo; </a>

10)     <a href="<page projects/projects>">Projects &raquo; </a>
11)     <a href="<page projects/torvm>">Tor VM</a>
12)   </div>
13) 	<div id="maincol">   
14)     
15)     <!-- PUT CONTENT AFTER THIS TAG -->
16)     
17)     <h1>Tor VM</h1>
18)     
19)     <!-- BEGIN SIDEBAR -->
20)     <div class="sidebar-left">
21)     <h3>Using Tor VM</h3>
22)     <ul>
23)     <li><a href="#Download">Download</a></li>
24)     <li><a href="#Install">Install</a></li>
25)     <li><a href="#Run">Run VM</a></li>
26)     <li><a href="#RecommendedUse">Use Torbutton</a></li>
27)     <li><a href="#Shutdown">Shutdown</a></li>
28)     </ul>
29)     </div>
30)     <!-- END SIDEBAR -->
31)     
32)     <h2>What Is It?</h2>
33)     <p>Tor VM is a transparent Tor proxy for Windows built with
34)     <a href="http://www.qemu.org/">Qemu</a> virtualization technology for more
35)     resilient clients and relays.
36)     </p>
37)     <p>You can think of Tor VM like a Tor virtual network card that routes all of the traffic
38)      from your machine transparently over the Tor network without application proxy settings or other configuration.
39)     </p>
40)     <p>The <a href="https://svn.torproject.org/svn/torvm/trunk/doc/design.html">Tor
41)     VM design document</a> contains additional detail about this work in progress.</p>
42)     

43)     <hr>

44)     <a id="Download"></a>
45)     <h2><a class="anchor" href="#Download">Step One: Download Tor VM Software</a></h2>
46)     
47)     <ul>
48)     <li><a href="dist/TorVM-0.0.2-Bundle.exe">Tor VM Bundle Installer</a>
49)     (<a href="dist/TorVM-0.0.2-Bundle.exe.asc" style="font-size: 90%;">sig</a>)</li>
50)     
51)     <li><a href="dist/TorVM-0.0.2-NetInstaller.exe">Tor VM Network Installer</a>
52)     (<a href="dist/TorVM-0.0.2-NetInstaller.exe.asc" style="font-size: 90%;">sig</a>)</li>
53)     </ul>
54)     

55)     <hr>

56)     <a id="Install"></a>
57)     <h2><a class="anchor" href="#Install">Step Two: Install Tor VM</a></h2>
58)     
59)     <p>Double click on the Bundle or Network Installer EXE to begin installation to the
60)     current system.</p>
61)     

62)     <p><img src="img/bundle02.png" alt="Click to Run Bundle Installer"></p>

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

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

68)     
69)     

70)     <hr>

71)     <a id="Run"></a>
72)     <h2><a class="anchor" href="#Run">Step Three: Run Tor VM</a></h2>
73)     
74)     <p>When installation is complete a Tor VM controller is started in
75)     the background. The installer program has finished and can be closed.</p>
76)     

77)     <p><img src="img/run01.png" alt="Tor VM controller will start at end of install"></p>

78)     
79)     <p>After preparing network devices a Qemu virtual machine running the
80)     Tor VM kernel is launched with the Vidalia controller. It may take a
81)     few minutes to bootstrap into the Tor network. Please be patient.</p>
82)     

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

84)     

85)     <hr>

86)     <a id="RecommendedUse"></a>
87)     <h2><a class="anchor" href="#RecommendedUse">Step Four: Using Firefox and Torbutton</a></h2>
88)     
89)     <p>Once Tor has successfully built a circuit the Switch User menu is presented.
90)     Firefox and other Tor applications must be run with the "Tor" restricted user account.</p>
91)     

92)     <p><img src="img/tor-user-switch.png" alt="Switch to Tor restricted user account"></p>

93)     
94)     <p>Start Firefox and click on the Torbutton status icon in the lower right to enable Tor.</p>
95)     

96)     <p><img src="img/torbutton04.png" alt="Click on Torbutton status icon to toggle ON"></p>

97)     
98)     <p>Verify that you are using Tor via
99)     <a href="https://check.torproject.org/">https://check.torproject.org/</a></p>
100)     

101)     <p><img src="img/torbutton05.png" alt="Verify Tor use at check.torproject.org"></p>

102)     
103)     

104)     <hr>

105)     <a id="ExperimentalUse"></a> 
106)     <h2><a class="anchor" href="#ExperimentalUse">Experimental: Using Flash</a></h2>
107)     
108)     <p><strong>IMPORTANT: This is not a recommended use of Tor.</strong></p>
109)     
110)     <p>Right click on Torbutton icon at lower right for menu. Select "Preferences..."
111)     option.</p>
112)     

113)     <p><img src="img/tbprefs.png" alt="Select Torbutton Preferences menu option"></p>

114)     
115)     <p>Toggle the "Disable plugins..." dynamic content security setting.</p>
116)     

117)     <p><img src="img/tbcontent.png" alt="Toggle disable plugins dynamic content security setting"></p>

118)     
119)     <p>Connections made from the Browser and Flash Player plugin will now
120)     be transparently proxied through the Tor network when viewing content.</p>
121)     

122)     <p><img src="img/flash02.png" alt="Flash player and other software now using Tor"></p>

123)     

124)     <hr>

125)     <a id="Shutdown"></a>
126)     <h2><a class="anchor" href="#Shutdown">Step Five: Shutdown Tor VM</a></h2>
127)     
128)     <p>Press The Windows Key + L to switch back to administrator User.</p>
129)     

130)     <p><img src="img/win-el.png" alt="Windows Key + L to switch user"></p>

131)     

132)     <p><img src="img/admin-user-switchback.png" alt="Switch back to admin user account"></p>

133)     
134)     <p>Select the Vidalia "Exit" option to shutdown the VM and restore network settings.
135)     The restricted Tor user will be logged off automatically.</p>
136)     

137)     <p><img src="img/exit-vidalia.png" alt="Select Vidalia Exit option to close VM"></p>

138)     
139)     <p>Do not close the Tor VM controller window while restoring network settings.</p>
140)     

141)     <p><img src="img/vm-shutdown.png" alt="Do not close the Tor VM window while restoring network settings"></p>

142)     
143)     

144)     <hr>

145)     <a id="Remove"></a>
146)     <h2><a class="anchor" href="#Remove">Uninstall Tor Bundle Software</a></h2>
147)     
148)     <p>A script to uninstall all of the Tor bundle applications is placed
149)     on the desktop. Run this utility to remove all of the Tor software and files.</p>
150)     

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

152)     
153)     

154)     <hr>