[or-cvs] first iteration of the switchproxy howto

Tue Jul 19 08:01:05 UTC 2005

Update of /home2/or/cvsroot/tor/doc
In directory moria:/home/arma/work/onion/cvs/tor/doc

Added Files:
	tor-switchproxy.html 
Log Message:
first iteration of the switchproxy howto

--- NEW FILE: tor-switchproxy.html ---
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>
<head>
<title>Tor SwitchProxy 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>Installing SwitchProxy for <a href="http://tor.eff.org/">Tor</a></h1>

<p>
SwitchProxy is a Firefox plugin that makes it easy for you to switch
between using a proxy and connecting to websites directly.</p>

In this howto, you're going to set up SwitchProxy to let you change
between using Privoxy and a direct connection. We assume you already
have Firefox installed and working.

<hr />

<a name="zero"></a>
<h3>Step Zero: Download and Install Tor and Privoxy</h3>

Before you start, you need to do <a
href="http://tor.eff.org/doc/tor-doc-win32.html#installing">step one</a>
and <a href="http://tor.eff.org/doc/tor-doc-win32.html#privoxy">step
two</a> of the Tor installation howto. When you're done, Tor will be up
and running, Privoxy will be up and running, and Privoxy will be configured
to point to Tor.

<hr />

<a name="one"></a>
<h3>Step One: Download and Install SwitchProxy</h3>

SwitchProxy is a Firefox plugin, so you need to go through
the process of installing a new plugin. First, go to the <a
href="https://addons.mozilla.org/extensions/moreinfo.php?application=firefox&id=125">
SwitchProxy</a> web page. It looks like this -- click on the "Install
Now" button.

<img alt="switchproxy web page"
src="http://tor.eff.org/img/screenshot-switchproxy-webpage.jpg" />

It will pop up a window asking for permission to install the plugin.
Click on "Install Now":

<img alt="firefox plugin warning"
src="http://tor.eff.org/img/screenshot-switchproxy-plugin-starting.jpg" />

<p>Once the installer is finished, it will tell you that you SwitchProxy
will be working once you restart Firefox:</p>

<img alt="firefox plugin finished"
src="http://tor.eff.org/img/screenshot-switchproxy-plugin-finished.jpg" />

<hr />

<a name="two"></a>
<h3>Step Two: Configure SwitchProxy</h3>

Now restart your Firefox. You'll notice there's now a new toolbar
that lets you control your proxies. Now we're going to set up a proxy
configuration for Privoxy. Click on "add":

<img alt="new toolbar"
src="http://tor.eff.org/img/screenshot-switchproxy-toolbar.jpg" />

It will ask to select a proxy type. Choose "Standard." (There's also
an "anonymous" proxy type that uses an ad hoc set of anonymous proxies
out there. You don't want this -- Tor is better.)

<img alt="standard proxy"
src="http://tor.eff.org/img/screenshot-switchproxy-proxytype.jpg" />

Now it will show you the standard proxy config window for Firefox.
Give this configuration a proxy label of "tor". Then fill in "localhost"
and "8118" for the first two entries, as shown here. Then click "OK":

<img alt="proxy config"
src="http://tor.eff.org/img/screenshot-switchproxy-proxyconfig.jpg" />

Now you've created the "tor" proxy label, but you're not using it yet.
Click on the pull-down list and select tor, as shown here:

<img alt="switch to tor"
src="http://tor.eff.org/img/screenshot-switchproxy-switch.jpg" />

Almost done. It may look like you're using Tor now, but you need to
click "Apply" to make your change take effect:

<img alt="apply"
src="http://tor.eff.org/img/screenshot-switchproxy-apply.jpg" />

Done! Firefox will reload your current page. In this example screenshot,
it reloaded google.com and happened to get a German exit node:

<img alt="german google"
src="http://tor.eff.org/img/screenshot-switchproxy-german.jpg" />

<hr />

If you have suggestions for improving this document, please <a
href="mailto:tor-bugs at freehaven.net">send them to us</a>. Thanks!

<p>$Id: tor-switchproxy.html,v 1.1 2005/07/19 08:01:03 arma Exp $</p>
</body>
</html>