2005-06-06 16:54:19 +02:00
|
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
2005-01-05 03:41:59 +01:00
|
|
|
|
|
|
|
|
<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>
|
|
|
|
|
|
2005-03-16 00:03:33 +01:00
|
|
|
<h1>Running the <a href="http://tor.eff.org/">Tor</a> client on Mac OS X</h1>
|
2005-01-05 03:41:59 +01:00
|
|
|
|
|
|
|
|
<a name="installing"></a>
|
|
|
|
|
<h2>Step One: Download and Install Tor</h2>
|
2005-03-16 00:03:33 +01:00
|
|
|
<p>
|
2005-05-06 07:11:06 +02:00
|
|
|
<b>Note that these are the installation instructions for running a client on
|
2005-04-01 19:17:08 +02:00
|
|
|
Mac OS X. If you want to run a server (please do), read the "Configuring a
|
|
|
|
|
server" section at <a href="tor-doc.html#server">tor-doc.html</a>.</b>
|
2005-03-16 00:03:33 +01:00
|
|
|
</p>
|
2005-03-29 22:32:42 +02:00
|
|
|
<p>
|
2005-06-26 07:25:28 +02:00
|
|
|
This document was updated $Date$.
|
2005-03-29 22:32:42 +02:00
|
|
|
</p>
|
2005-01-05 03:41:59 +01:00
|
|
|
<p>
|
|
|
|
|
The latest beta release of Tor for Macintosh OS X is <a
|
2005-07-15 01:35:11 +02:00
|
|
|
href="http://tor.eff.org/dist/osx/Tor 0.1.1.2-alpha Bundle.dmg">0.1.1.2-alpha</a>.
|
2005-01-05 03:41:59 +01:00
|
|
|
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.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>Our Tor installer should make everything pretty simple. Below is a
|
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):
|
2005-01-05 03:41:59 +01:00
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<img alt="tor installer splash page"
|
|
|
|
|
src="http://tor.eff.org/img/screenshot-osx-installer-splash.png"
|
|
|
|
|
border="1">
|
|
|
|
|
|
|
|
|
|
<p>
|
2005-03-19 00:09:29 +01:00
|
|
|
By default, Tor is configured to run at startup. If you do not want Tor to
|
|
|
|
|
run on startup, you can disable this by selecting "Customize" in the
|
|
|
|
|
Installer, and then un-checking the "Tor Startup Script" box. Be sure to
|
|
|
|
|
leave the other boxes checked.
|
2005-01-05 03:41:59 +01:00
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>Once the installer is finished and your computer restarts, Tor will
|
|
|
|
|
start automatically. Tor comes configured as a client by default. It
|
2005-03-19 00:09:29 +01:00
|
|
|
uses a built-in default configuration file in <tt>/Library/Tor/torrc</tt>,
|
|
|
|
|
but most people won't need to change any of the settings. Tor is now
|
|
|
|
|
installed.</p>
|
2005-01-05 03:41:59 +01:00
|
|
|
|
|
|
|
|
<p>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.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>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.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<a name="using"></a>
|
|
|
|
|
<h2>Step Two: Configure your applications to use Tor</h2>
|
|
|
|
|
|
|
|
|
|
<p>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.
|
2005-01-05 15:25:53 +01:00
|
|
|
(That's where Privoxy listens.)
|
|
|
|
|
In Mozilla, this is in Mozilla|Preferences|Advanced|Proxies.
|
|
|
|
|
In Firefox it's Firefox|Preferences|General|ConnectionSettings.
|
|
|
|
|
You should set both your Web Proxy (HTTP) and your Secure Web Proxy
|
|
|
|
|
(HTTPS or SSL) to localhost port 8118, to hide your SSL traffic too.
|
2005-01-05 03:41:59 +01:00
|
|
|
|
2005-01-05 15:25:53 +01:00
|
|
|
<p>If you want to use Tor with Safari, you need to change your
|
|
|
|
|
Network Settings. The process looks something like:</p>
|
2005-01-05 03:41:59 +01:00
|
|
|
|
|
|
|
|
<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>
|
|
|
|
|
|
|
|
|
|
<p>Select the Network Interface you want to enable Tor on. If you use
|
2005-01-05 03:58:05 +01:00
|
|
|
more than one Interface you must change the proxy settings for each
|
2005-01-05 03:41:59 +01:00
|
|
|
individually.</p>
|
|
|
|
|
|
|
|
|
|
<img alt="Proxy settings in IE"
|
|
|
|
|
src="http://tor.eff.org/img/screenshot-osx-proxy-settings.png"
|
|
|
|
|
border="1">
|
|
|
|
|
|
2005-06-09 04:14:32 +02:00
|
|
|
<p>Select and enter 127.0.0.1 and port 8118 for both Web Proxy (HTTP)
|
|
|
|
|
and your Secure Web Proxy (HTTPS). Leave your Use Passive FTP Mode (PASV) setting as is.</p>
|
2005-01-05 03:41:59 +01:00
|
|
|
|
|
|
|
|
<p>Using privoxy is <strong>necessary</strong> because <a
|
2005-05-25 00:28:21 +02:00
|
|
|
href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#SOCKSAndDNS">browsers
|
|
|
|
|
leak your
|
2005-01-05 03:41:59 +01:00
|
|
|
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>
|
|
|
|
|
|
2005-06-10 01:59:18 +02:00
|
|
|
<p>To test if it's working, you need to know your normal IP address
|
2005-05-12 21:57:08 +02:00
|
|
|
so you can verify that the address really changes when running Tor.
|
2005-06-10 01:59:18 +02:00
|
|
|
Your local IP address is shown by the <tt>ifconfig</tt> command.
|
|
|
|
|
If you are behind a NAT/Firewall you can use one of the sites listed
|
2005-05-12 21:57:08 +02:00
|
|
|
below to check which IP you are using.
|
|
|
|
|
When that is done, start Tor and Privoxy and visit any of the sites again.
|
|
|
|
|
If everything works, your IP address should have changed.
|
2005-05-13 20:16:51 +02:00
|
|
|
</p>
|
2005-05-12 21:57:08 +02:00
|
|
|
|
|
|
|
|
<p>
|
2005-05-12 00:26:37 +02:00
|
|
|
<!--<a href="http://peertech.org/privacy-knoppix/">peertech</a>, -->
|
2005-07-14 03:15:15 +02:00
|
|
|
<a href="http://ipid.shat.net">ipid.shat.net</a> and
|
|
|
|
|
<a href="http://www.showmyip.com/">showmyip.com</a>
|
2005-05-13 20:16:51 +02:00
|
|
|
are sites that show your current IP so you can see
|
2005-05-12 21:57:08 +02:00
|
|
|
what address and country you're coming from.
|
2005-03-16 22:24:45 +01:00
|
|
|
</p>
|
2005-01-05 03:41:59 +01:00
|
|
|
|
|
|
|
|
<p>
|
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.
|
2005-01-05 03:41:59 +01:00
|
|
|
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.taiyo.co.jp/~gotoh/ssh/connect.html">connect</a> or
|
2005-06-10 01:59:18 +02:00
|
|
|
<a href="http://www.dest-unreach.org/socat/">socat</a>.
|
2005-03-16 22:24:45 +01:00
|
|
|
<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>.
|
2005-01-05 03:41:59 +01:00
|
|
|
<p>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!</p>
|
|
|
|
|
|
2005-06-09 20:43:43 +02:00
|
|
|
<h2>How To Uninstall</h2>
|
|
|
|
|
|
|
|
|
|
<p>The Tor 0.1.0.x series does not come with an uninstaller; this feature
|
|
|
|
|
will be added in the 0.1.1.x series. If you want to remove Tor on OSX,
|
|
|
|
|
here's how:</p>
|
|
|
|
|
|
|
|
|
|
<p>Change your application proxy settings back to their original values.
|
|
|
|
|
If you just want to stop using Tor, you can end at this point.</p>
|
|
|
|
|
|
|
|
|
|
<p>To stop Tor and Privoxy from running on startup</b>, remove the
|
|
|
|
|
/Library/StartupItems/Tor and /Library/StartupItems/Privoxy directories
|
|
|
|
|
respectively. If you just want to stop Tor from running, you can end at this
|
|
|
|
|
point.</p>
|
|
|
|
|
|
|
|
|
|
<p>To erase all remaining Tor and Privoxy files from your computer, delete
|
|
|
|
|
the following:
|
|
|
|
|
<ul><li>/Library/Tor</li>
|
|
|
|
|
<li>/Library/Privoxy</li>
|
|
|
|
|
<li>/usr/bin/tor</li>
|
|
|
|
|
<li>/usr/bin/tor_resolve</li>
|
|
|
|
|
<li>/var/log/tor</li>
|
|
|
|
|
<li>/usr/share/man/man1/tor.1</li>
|
|
|
|
|
<li>/usr/share/man/man1/tor-resolve.1</li>
|
|
|
|
|
<li>/usr/share/man/man1/torify.1</li>
|
|
|
|
|
</ul>
|
|
|
|
|
</p>
|
|
|
|
|
|
2005-06-26 07:25:28 +02:00
|
|
|
<p>$Id$</p>
|
|
|
|
|
|
2005-01-05 03:41:59 +01:00
|
|
|
</body>
|
|
|
|
|
</html>
|
|
|
|
|
|
