[or-cvs] and the first cut of a tor osx installation howto

Wed Jan 5 02:42:02 UTC 2005

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

Added Files:
	tor-doc-osx.html 
Log Message:
and the first cut of a tor osx installation howto

--- NEW FILE: tor-doc-osx.html ---

<html>
<head>
<title>Tor Mac OS X Install Instructions</title>
<meta name="Author" content="Thomas Hardly">
<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 <a href="http://tor.eff.org/">Tor</a> on Mac OS X</h1>

<a name="installing"></a>
<h2>Step One: Download and Install Tor</h2>

The latest beta release of Tor for Macintosh OS X is <a
href="http://tor.eff.org/dist/osx/Tor 0.0.9.2 Bundle.dmg">0.0.9.2</a>.
Download it by clicking the link. You may be able to find experimental versions
<a href="http://tor.freehaven.net/dist/osx/">here</a>, if you're looking for
new features and new bugs.

Our Tor installer should make everything pretty simple. Below is a
screenshot of the setup page:

<img alt="tor installer splash page"
src="http://tor.eff.org/img/screenshot-osx-installer-splash.png"
border="1">

By default, Tor is not configured to run at startup.

You can enable this by selecting "Customize" in the Installer.

<img alt="select components to install"
src="http://tor.eff.org/img/screenshot-osx-installer-customize.png"
border="1">

And then checking the "Tor Startup Script" box as shown below.
Be sure to leave the other boxes checked.

<img alt="select components to install"
src="http://tor.eff.org/img/screenshot-osx-installer-components.png"
border="1">

Once the installer is finished and your computer restarts, Tor will
start automatically. 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.

Privoxy is installed as part of the Tor bundle package
installer. Privoxy is a filtering web proxy that integrates well with
Tor. Once it's installed, it will start automatically when your computer
is restarted.

You do not need to configure Privoxy to use Tor. A custom Privoxy
configuration for Tor has been installed as part of the installer package.

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

After installing Tor, you need to configure your applications to use
it. The first step is to set up web browsing.
Change your browser to HTTP proxy at localhost port 8118.
(That's where Privoxy listens.) For Safari you need to change your
Network Settings. Other web browers allow you to change proxy settings
individually.

You should set both your Web Proxy (HTTP) and your Secure Web Proxy
(HTTPS) to the same thing, to hide your SSL traffic. For Safari, this
looks something like:

<img alt="LAN settings in IE"
src="http://tor.eff.org/img/screenshot-osx-choose-network.png"
border="1">

<p>
Select your Network Preferences from the Apple | Location menu.</p>

<img alt="Proxy settings in IE"
src="http://tor.eff.org/img/screenshot-osx-choose-interface.png"
border="1">
<P>

Select the Network Interface you want to enable Tor on. If you use
more than one Interface you must change the proxie settings for each
individually.

<img alt="Proxy settings in IE"
src="http://tor.eff.org/img/screenshot-osx-proxy-settings.png"
border="1">

<p>Select and enter localhost and port 8118 for both Web Proxy (HTTP)
and your Secure Web Proxy (HTTPS)</p>

Using privoxy is necessary 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.

To test if it's working, go to <a
href="http://peertech.org/privacy-knoppix/">this site</a> and see
what IP it says you're coming from. (If it's down, you can try the
<a href="http://www.junkbusters.com/cgi-bin/privacy">junkbusters</a>
site instead.)

If you have a personal firewall, be sure to allow local connections to
port 8118 and port 9050. If your firewall blocks outgoing connections,
punch a hole so it can connect to TCP ports 80, 443, and 9001-9033.
For more troubleshooting suggestions, see <a
href="http://wiki.noreply.org/wiki/TheOnionRouter/TorFAQ">the FAQ</a>.

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.taiyo.co.jp/~gotoh/ssh/connect.html">connect</a> or
<a href="http://www.dest-unreach.org/socat/">socat</a>. Let us know if
you get them working so we can add better instructions here.

If you have suggestions for improving this document, please post
them on <a href="http://bugs.noreply.org/tor">our bugtracker</a> in the
website category. Thanks!

</body>
</html>