tor/doc/tor-doc-win32.html

<html>
<head>
<title>Tor Win32 Install Instructions</title>
<meta name="Author" content="Roger Dingledine">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="Content-Style-Type" content="text/css">
<link rel="stylesheet" type="text/css" href="tor-doc.css">
</head>

<body>

<h1>Running the <a href="http://tor.eff.org/">Tor</a> client on Win32</h1>

<a name="installing"></a>
<h2>Step One: Download and Install Tor</h2>
<p>
<b>Note that this is the installation instructions for running a client on Win32. If you want to run a server, please read the "Configuring a server" section in <a href="./tor-doc.html">tor-doc.html</a>.</b>
</p>

<p>
The latest stable release of Tor for Windows 32 is <a
href="http://tor.eff.org/dist/win32/tor-0.0.9.5-win32.exe">0.0.9.5</a>.
Download it by clicking the link. You may be able to find experimental versions
<a href="http://tor.eff.org/dist/win32/">here</a>, if you're looking for
new features and new bugs.
</p>

<p>Our Tor installer should make everything pretty simple. Below is a
screenshot of the setup page (your version will probably be newer than
the version printed in this screenshot):
</p>

<img alt="tor installer splash page"
src="http://tor.eff.org/img/screenshot-win32-installer-splash.jpg" />

<p>
By default, Tor is not configured to run at startup.
<!--We highly recommend that you enable that feature, however. -->
You can enable this by checking the "Run at startup" box as shown below.
Be sure to leave the other boxes checked.
</p>

<img alt="select components to install"
src="http://tor.eff.org/img/screenshot-win32-installer-components.jpg" />

<p>Once the installer is finished, it will run Tor in a DOS window so
you can see its logs and errors. (You can minimize this window, but do
not close it.)
</p>

<img alt="tor window screenshot"
src="http://tor.eff.org/img/screenshot-win32-dos-window.jpg" />

<p>Tor comes configured as a client by default. It uses a built-in
default configuration file, and most people won't need to change any of
the settings. Tor is now installed.</p>

<a name="privoxy"></a>
<h2>Step Two: Install Privoxy for Web Browsing</h2>

<p>After installing Tor, you need to configure your applications to use it.
The first step is to set up web browsing. Start by installing <a
href="http://www.privoxy.org/">Privoxy</a> (click on 'recent releases',
then scroll down to the Win32 installer packages). Privoxy is a filtering
web proxy that integrates well with Tor. Once it's installed, it should
appear in your system tray as a "P" in a circle, as pictured below:
</p>

<img alt="privoxy icon in the system tray"
src="http://tor.eff.org/img/screenshot-win32-privoxy-icon.jpg" />

<p>You need to configure Privoxy to use Tor.
Open Privoxy's main config file by selecting it from Start Menu|All
Programs:
</p>

<img border="1" alt="editing privoxy config"
src="http://tor.eff.org/img/screenshot-win32-privoxy-config.jpg" />

<p>Add the line <br>
<tt>forward-socks4a / localhost:9050 .</tt><br>
to Privoxy's config file. Don't forget to add the dot at the end.
The easiest way is to select the above line and copy/paste it into
the file. Be sure to save.
</p>

<img border="1" alt="privoxy points to tor"
src="http://tor.eff.org/img/screenshot-win32-privoxy-edit.jpg" />

<a name="using"></a>
<h2>Step Three: Configure your applications to use Tor</h2>

<p>Then change your browser to HTTP proxy at localhost port 8118.
(That's where Privoxy listens.)
In Firefox it's Firefox|Preferences|General|ConnectionSettings.
In Mozilla, this is in Edit|Preferences|Advanced|Proxies. In IE, it's
Tools|Internet Options|Connections|LAN Settings|Advanced.
You should also set your SSL proxy (IE calls it "Secure") to the same
thing, to hide your SSL traffic too. In IE, this looks something like:</p>

<img alt="LAN settings in IE"
src="http://tor.eff.org/img/screenshot-win32-ie-lan.jpg" />
<img alt="Proxy settings in IE"
src="http://tor.eff.org/img/screenshot-win32-ie-proxies.jpg" />

<p>Using privoxy is <strong>necessary</strong> because <a
href="http://tor.eff.org/cvs/tor/doc/CLIENTS">browsers leak your
DNS requests when they use a SOCKS proxy directly</a>, which is bad for
your anonymity. Privoxy also removes certain dangerous headers from your
web requests, and blocks obnoxious ad sites like Doubleclick.</p>

<p>To test if it's working, go to <a
href="http://peertech.org/privacy-knoppix/">peertech</a>,
<a href="http://www.junkbusters.com/cgi-bin/privacy">junkbusters</a> or
<a href="http://www.network-tools.com">network-tools</a>
and see what IP it says you're coming from.
</p>
<p>
If you have a personal firewall that limits your computer's ability
to connect to itself, be sure to allow connections from your local
applications to
local port 8118 and port 9050. If your firewall blocks outgoing connections,
punch a hole so it can connect to at least TCP ports 80, 443, and 9001-9033.
For more troubleshooting suggestions, see <a
href="http://wiki.noreply.org/wiki/TheOnionRouter/TorFAQ">the FAQ</a>.
</p>

<p>To Torify another application that supports HTTP, just point it at Privoxy
(that is, localhost port 8118). To use SOCKS directly (for example, for
instant messaging, Jabber, IRC, etc), point your application directly at
Tor (localhost port 9050). For applications that support neither SOCKS
nor HTTP, take a look at <a
href="http://www.socks.permeo.com/Download/SocksCapDownload/index.asp">SocksCap</a>,
<a href="http://www.freecap.ru/eng/">FreeCap</a>,
or the <a
href="http://www.hummingbird.com/products/nc/socks/index.html?cks=y">Hummingbird</a>
SOCKS client. (FreeCap is free software; the others are proprietary.)<br />
For more information how to Torify other applications in detail visit
the <a href="http://wiki.noreply.org/wiki/TheOnionRouter/TorifyHOWTO">Torify HOWTO</a>.
<p>If you have suggestions for improving this document, please <a
href="mailto:tor-bugs@freehaven.net">send them to us</a>. Thanks!</p>

</body>
</html>
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00			`<html>`
			`<head>`
it is beautiful now svn:r3187 2004-12-19 08:36:05 +01:00			`<title>Tor Win32 Install Instructions</title>`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00			`<meta name="Author" content="Roger Dingledine">`
			`<meta http-equiv="Content-Type" content="text/html; charset=utf-8">`
			`<meta http-equiv="Content-Style-Type" content="text/css">`
			`<link rel="stylesheet" type="text/css" href="tor-doc.css">`
			`</head>`

			`<body>`

Make it clear that tor-doc-{win32,osx}.html are for setting up clients and point those who want to set up a server to tor-doc.html svn:r3765 2005-03-16 00:03:33 +01:00			`<h1>Running the <a href="http://tor.eff.org/">Tor</a> client on Win32</h1>`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00
			`<a name="installing"></a>`
capitalize acronyms, clarify windows doc a bit. svn:r3197 2004-12-21 06:43:17 +01:00			`<h2>Step One: Download and Install Tor</h2>`
Make it clear that tor-doc-{win32,osx}.html are for setting up clients and point those who want to set up a server to tor-doc.html svn:r3765 2005-03-16 00:03:33 +01:00			`<p>`
			`<b>Note that this is the installation instructions for running a client on Win32. If you want to run a server, please read the "Configuring a server" section in <a href="./tor-doc.html">tor-doc.html</a>.</b>`
			`</p>`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00
more cleanup and screenshots for tor-doc-win32 svn:r3184 2004-12-19 07:22:20 +01:00			`<p>`
even more cleanup svn:r3185 2004-12-19 07:31:24 +01:00			`The latest stable release of Tor for Windows 32 is <a`
and to the win32 and os x doc pages svn:r3669 2005-02-23 08:09:54 +01:00			`href="http://tor.eff.org/dist/win32/tor-0.0.9.5-win32.exe">0.0.9.5</a>.`
give the screenshot images actual names svn:r3196 2004-12-21 05:31:22 +01:00			`Download it by clicking the link. You may be able to find experimental versions`
migrate to the new URL svn:r3296 2005-01-05 01:06:51 +01:00			`<a href="http://tor.eff.org/dist/win32/">here</a>, if you're looking for`
give the screenshot images actual names svn:r3196 2004-12-21 05:31:22 +01:00			`new features and new bugs.`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00			`</p>`

even more cleanup svn:r3185 2004-12-19 07:31:24 +01:00			`<p>Our Tor installer should make everything pretty simple. Below is a`
make it clearer that our screenshots are of old versions. svn:r3634 2005-02-18 04:38:38 +01:00			`screenshot of the setup page (your version will probably be newer than`
			`the version printed in this screenshot):`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00			`</p>`

more cleanup and screenshots for tor-doc-win32 svn:r3184 2004-12-19 07:22:20 +01:00			`<img alt="tor installer splash page"`
point to the new screenshot file names svn:r3297 2005-01-05 03:18:15 +01:00			`src="http://tor.eff.org/img/screenshot-win32-installer-splash.jpg" />`
more cleanup and screenshots for tor-doc-win32 svn:r3184 2004-12-19 07:22:20 +01:00
			`<p>`
			`By default, Tor is not configured to run at startup.`
			`<!--We highly recommend that you enable that feature, however. -->`
			`You can enable this by checking the "Run at startup" box as shown below.`
			`Be sure to leave the other boxes checked.`
			`</p>`

			`<img alt="select components to install"`
point to the new screenshot file names svn:r3297 2005-01-05 03:18:15 +01:00			`src="http://tor.eff.org/img/screenshot-win32-installer-components.jpg" />`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00
even more cleanup svn:r3185 2004-12-19 07:31:24 +01:00			`<p>Once the installer is finished, it will run Tor in a DOS window so`
			`you can see its logs and errors. (You can minimize this window, but do`
			`not close it.)`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00			`</p>`

give the screenshot images actual names svn:r3196 2004-12-21 05:31:22 +01:00			`<img alt="tor window screenshot"`
point to the new screenshot file names svn:r3297 2005-01-05 03:18:15 +01:00			`src="http://tor.eff.org/img/screenshot-win32-dos-window.jpg" />`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00
			`<p>Tor comes configured as a client by default. It uses a built-in`
			`default configuration file, and most people won't need to change any of`
clean up docs some more point to coderman's knoppix site rather than junkbusters svn:r3175 2004-12-18 18:15:52 +01:00			`the settings. Tor is now installed.</p>`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00
capitalize acronyms, clarify windows doc a bit. svn:r3197 2004-12-21 06:43:17 +01:00			`<a name="privoxy"></a>`
			`<h2>Step Two: Install Privoxy for Web Browsing</h2>`
it is beautiful now svn:r3187 2004-12-19 08:36:05 +01:00
			`<p>After installing Tor, you need to configure your applications to use it.`
			`The first step is to set up web browsing. Start by installing <a`
clean up docs some more point to coderman's knoppix site rather than junkbusters svn:r3175 2004-12-18 18:15:52 +01:00			`href="http://www.privoxy.org/">Privoxy</a> (click on 'recent releases',`
			`then scroll down to the Win32 installer packages). Privoxy is a filtering`
more cleanup and screenshots for tor-doc-win32 svn:r3184 2004-12-19 07:22:20 +01:00			`web proxy that integrates well with Tor. Once it's installed, it should`
it is beautiful now svn:r3187 2004-12-19 08:36:05 +01:00			`appear in your system tray as a "P" in a circle, as pictured below:`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00			`</p>`

give the screenshot images actual names svn:r3196 2004-12-21 05:31:22 +01:00			`<img alt="privoxy icon in the system tray"`
point to the new screenshot file names svn:r3297 2005-01-05 03:18:15 +01:00			`src="http://tor.eff.org/img/screenshot-win32-privoxy-icon.jpg" />`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00
more cleanup and screenshots for tor-doc-win32 svn:r3184 2004-12-19 07:22:20 +01:00			`<p>You need to configure Privoxy to use Tor.`
clean tor-doc-win32 a bit more svn:r3215 2004-12-23 02:08:10 +01:00			`Open Privoxy's main config file by selecting it from Start Menu\|All`
			`Programs:`
more cleanup and screenshots for tor-doc-win32 svn:r3184 2004-12-19 07:22:20 +01:00			`</p>`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00
give the screenshot images actual names svn:r3196 2004-12-21 05:31:22 +01:00			`<img border="1" alt="editing privoxy config"`
point to the new screenshot file names svn:r3297 2005-01-05 03:18:15 +01:00			`src="http://tor.eff.org/img/screenshot-win32-privoxy-config.jpg" />`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00
			`<p>Add the line <br>`
			`<tt>forward-socks4a / localhost:9050 .</tt><br>`
more cleanup and screenshots for tor-doc-win32 svn:r3184 2004-12-19 07:22:20 +01:00			`to Privoxy's config file. Don't forget to add the dot at the end.`
			`The easiest way is to select the above line and copy/paste it into`
			`the file. Be sure to save.`
			`</p>`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00
give the screenshot images actual names svn:r3196 2004-12-21 05:31:22 +01:00			`<img border="1" alt="privoxy points to tor"`
point to the new screenshot file names svn:r3297 2005-01-05 03:18:15 +01:00			`src="http://tor.eff.org/img/screenshot-win32-privoxy-edit.jpg" />`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00
capitalize acronyms, clarify windows doc a bit. svn:r3197 2004-12-21 06:43:17 +01:00			`<a name="using"></a>`
clean tor-doc-win32 a bit more svn:r3215 2004-12-23 02:08:10 +01:00			`<h2>Step Three: Configure your applications to use Tor</h2>`
capitalize acronyms, clarify windows doc a bit. svn:r3197 2004-12-21 06:43:17 +01:00
			`<p>Then change your browser to HTTP proxy at localhost port 8118.`
			`(That's where Privoxy listens.)`
Mozilla/Firefox instructions present in both win32 and osx. Added network-tools.com as a IP-test site. svn:r3768 2005-03-16 22:24:45 +01:00			`In Firefox it's Firefox\|Preferences\|General\|ConnectionSettings.`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00			`In Mozilla, this is in Edit\|Preferences\|Advanced\|Proxies. In IE, it's`
			`Tools\|Internet Options\|Connections\|LAN Settings\|Advanced.`
			`You should also set your SSL proxy (IE calls it "Secure") to the same`
clean up osx/win32/generic instructions svn:r3309 2005-01-05 15:25:53 +01:00			`thing, to hide your SSL traffic too. In IE, this looks something like:</p>`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00
give the screenshot images actual names svn:r3196 2004-12-21 05:31:22 +01:00			`<img alt="LAN settings in IE"`
point to the new screenshot file names svn:r3297 2005-01-05 03:18:15 +01:00			`src="http://tor.eff.org/img/screenshot-win32-ie-lan.jpg" />`
give the screenshot images actual names svn:r3196 2004-12-21 05:31:22 +01:00			`<img alt="Proxy settings in IE"`
point to the new screenshot file names svn:r3297 2005-01-05 03:18:15 +01:00			`src="http://tor.eff.org/img/screenshot-win32-ie-proxies.jpg" />`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00
capitalize acronyms, clarify windows doc a bit. svn:r3197 2004-12-21 06:43:17 +01:00			`<p>Using privoxy is <strong>necessary</strong> because <a`
migrate to the new URL svn:r3296 2005-01-05 01:06:51 +01:00			`href="http://tor.eff.org/cvs/tor/doc/CLIENTS">browsers leak your`
capitalize acronyms, clarify windows doc a bit. svn:r3197 2004-12-21 06:43:17 +01:00			`DNS requests when they use a SOCKS proxy directly</a>, which is bad for`
clean up docs some more point to coderman's knoppix site rather than junkbusters svn:r3175 2004-12-18 18:15:52 +01:00			`your anonymity. Privoxy also removes certain dangerous headers from your`
even more cleanup svn:r3185 2004-12-19 07:31:24 +01:00			`web requests, and blocks obnoxious ad sites like Doubleclick.</p>`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00
			`<p>To test if it's working, go to <a`
Mozilla/Firefox instructions present in both win32 and osx. Added network-tools.com as a IP-test site. svn:r3768 2005-03-16 22:24:45 +01:00			`href="http://peertech.org/privacy-knoppix/">peertech</a>,`
			`<a href="http://www.junkbusters.com/cgi-bin/privacy">junkbusters</a> or`
			`<a href="http://www.network-tools.com">network-tools</a>`
			`and see what IP it says you're coming from.`
			`</p>`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00			`<p>`
clean up osx/win32/generic instructions svn:r3309 2005-01-05 15:25:53 +01:00			`If you have a personal firewall that limits your computer's ability`
			`to connect to itself, be sure to allow connections from your local`
			`applications to`
			`local port 8118 and port 9050. If your firewall blocks outgoing connections,`
			`punch a hole so it can connect to at least TCP ports 80, 443, and 9001-9033.`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00			`For more troubleshooting suggestions, see <a`
			`href="http://wiki.noreply.org/wiki/TheOnionRouter/TorFAQ">the FAQ</a>.`
			`</p>`

capitalize acronyms, clarify windows doc a bit. svn:r3197 2004-12-21 06:43:17 +01:00			`<p>To Torify another application that supports HTTP, just point it at Privoxy`
			`(that is, localhost port 8118). To use SOCKS directly (for example, for`
it is beautiful now svn:r3187 2004-12-19 08:36:05 +01:00			`instant messaging, Jabber, IRC, etc), point your application directly at`
capitalize acronyms, clarify windows doc a bit. svn:r3197 2004-12-21 06:43:17 +01:00			`Tor (localhost port 9050). For applications that support neither SOCKS`
			`nor HTTP, take a look at <a`
point people to freecap as well as sockscap svn:r3186 2004-12-19 07:34:23 +01:00			`href="http://www.socks.permeo.com/Download/SocksCapDownload/index.asp">SocksCap</a>,`
			`<a href="http://www.freecap.ru/eng/">FreeCap</a>,`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00			`or the <a`
			`href="http://www.hummingbird.com/products/nc/socks/index.html?cks=y">Hummingbird</a>`
Mozilla/Firefox instructions present in both win32 and osx. Added network-tools.com as a IP-test site. svn:r3768 2005-03-16 22:24:45 +01:00			`SOCKS client. (FreeCap is free software; the others are proprietary.)<br />`
			`For more information how to Torify other applications in detail visit`
			`the <a href="http://wiki.noreply.org/wiki/TheOnionRouter/TorifyHOWTO">Torify HOWTO</a>.`
more cleanup and screenshots for tor-doc-win32 svn:r3184 2004-12-19 07:22:20 +01:00			`<p>If you have suggestions for improving this document, please <a`
even more cleanup svn:r3185 2004-12-19 07:31:24 +01:00			`href="mailto:tor-bugs@freehaven.net">send them to us</a>. Thanks!</p>`
a first cut of win32 specific doc svn:r3174 2004-12-18 17:49:21 +01:00
			`</body>`
			`</html>`