tor-webwml.git

1) ## translation metadata
2) # Revision: $Revision$
3) 
4) #include "head.wmi" TITLE="Tor VM"
5) 
6) <div class="main-column">
7) 
8) <!-- PUT CONTENT AFTER THIS TAG -->
9) 

10) <h1>Tor VM</h1>

11) 

12) <!-- BEGIN SIDEBAR -->
13) <div class="sidebar-left">
14) <h3>Using Tor VM</h3>
15) <ul>
16) <li><a href="#Download">Download</a></li>

17) <li><a href="#Install">Install</a></li>

18) <li><a href="#Run">Run VM</a></li>

19) <li><a href="#RecommendedUse">Use Torbutton</a></li>

20) <li><a href="#Shutdown">Shutdown</a></li>

21) </ul>
22) </div>
23) <!-- END SIDEBAR -->
24) 

25) <h2>What Is It?</h2>

26) <p>Tor VM is a transparent Tor proxy for Windows built with

27) <a href="http://www.qemu.org/">Qemu</a> virtualization technology for more
28) resilient clients and relays.

29) </p>

30) <p>
31) The <a href="https://svn.torproject.org/svn/torvm/trunk/doc/design.html">Tor
32) VM design document</a> contains additional detail about this work in progress.</p>

33) 
34) <hr />

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

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

37) 

38) <ul>

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

41) 

42) <li><a href="dist/TorVM-0.0.2-NetInstaller.exe">Tor VM Network Installer</a>
43) (<a href="dist/TorVM-0.0.2-NetInstaller.exe.asc" style="font-size: 90%;">sig</a>)</li>

44) </ul>
45) 

46) <hr />

47) <a id="Install"></a>
48) <h2><a class="anchor" href="#Install">Step Two: Install Tor VM</a></h2>

49) 

50) <p>Double click on the Bundle or Network Installer EXE to begin installation to the
51) current system.</p>

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

55) <p>The network installer contains the secure Tor updater software that is used
56) to reliably download all of the latest bundle application packages on demand.</p>
57) 
58) <p><img src="img/netinst02.png" alt="Network Installer downloads bundle software on demand" /></p>
59) 

60) 
61) <hr />

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

63) <h2><a class="anchor" href="#Run">Step Three: Run Tor VM</a></h2>

64) 

65) <p>When installation is complete a Tor VM controller is started in

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

67) 

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

69) 
70) <p>After preparing network devices a Qemu virtual machine running the

71) Tor VM kernel is launched with the Vidalia controller. It may take a
72) few minutes to bootstrap into the Tor network. Please be patient.</p>

73) 

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

75) 

76) <hr />
77) <a id="RecommendedUse"></a>

78) <h2><a class="anchor" href="#RecommendedUse">Step Four: Using Firefox and Torbutton</a></h2>

79) 

80) <p>Once Tor has successfully built a circuit the Switch User menu is presented.
81) Firefox and other Tor applications must be run with the "Tor" restricted user account.</p>

82) 

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

84) 

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

86) 

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

88) 
89) <p>Verify that you are using Tor via
90) <a href="https://check.torproject.org/">https://check.torproject.org/</a></p>
91) 

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

93) 
94) 
95) <hr />
96) <a id="ExperimentalUse"></a> 
97) <h2><a class="anchor" href="#ExperimentalUse">Experimental: Using Flash</a></h2>
98) 

99) <p><strong>IMPORTANT: This is not a recommended use of Tor.</strong></p>

100) 

101) <p>Right click on Torbutton icon at lower right for menu. Select "Preferences..."
102) option.</p>

103) 

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

105) 

106) <p>Toggle the "Disable plugins..." dynamic content security setting.</p>

107) 

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

109) 
110) <p>Connections made from the Browser and Flash Player plugin will now
111) be transparently proxied through the Tor network when viewing content.</p>
112) 

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

114) 
115) <hr />

116) <a id="Shutdown"></a>
117) <h2><a class="anchor" href="#Shutdown">Step Five: Shutdown Tor VM</a></h2>

118) 

119) <p>Press The Windows Key + L to switch back to administrator User.</p>

120) 

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

122) 

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

124) 

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

127) 

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

129) 

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

133) 
134) 
135) <hr />

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

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

138) 

139) <p>A script to uninstall all of the Tor bundle applications is placed
140) on the desktop. Run this utility to remove all of the Tor software and files.</p>

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

144) 
145) <hr />

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

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

148) 
149) <p>The Tor VM category in the Tor flyspray bug tracker is used to manage
150) defects and features. See the

151) <a href="http://bugs.noreply.org/flyspray/index.php?tasks=all&amp;project=4"
152) >Tor flyspray bug tracker</a> for known issues and pending changes.</p>

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