doc/tor-doc-osx.html

   1
   2 <html>
   3 <head>
   4 <title>Tor Mac OS X Install Instructions</title>
   5 <meta name="Author" content="Thomas Hardly">
   6 <meta name="Author" content="Roger Dingledine">
   7 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
   8 <meta http-equiv="Content-Style-Type" content="text/css">
   9 <link rel="stylesheet" type="text/css" href="tor-doc.css">
  10 </head>
  11
  12 <body>
  13
  14 <h1>Running the <a href="http://tor.eff.org/">Tor</a> client on Mac OS X</h1>
  15
  16 <a name="installing"></a>
  17 <h2>Step One: Download and Install Tor</h2>
  18 <p>
  19 <b>Note that this is the installation instructions for running a client on
  20   Mac OS X. If you want to run a server, please read the "Configuring a
  21   server" section in <a href="./tor-doc.html">tor-doc.html</a>.</b>
  22 </p>
  23
  24 <p>
  25 The latest beta release of Tor for Macintosh OS X is <a
  26 href="http://tor.eff.org/dist/osx/Tor 0.0.9.5 Bundle.dmg">0.0.9.5</a>.
  27 Download it by clicking the link. You may be able to find experimental versions
  28 <a href="http://tor.freehaven.net/dist/osx/">here</a>, if you're looking for
  29 new features and new bugs.
  30 </p>
  31
  32 <p>Our Tor installer should make everything pretty simple. Below is a
  33 screenshot of the setup page (your version will probably be newer than
  34 the version printed in this screenshot):
  35 </p>
  36
  37 <img alt="tor installer splash page"
  38 src="http://tor.eff.org/img/screenshot-osx-installer-splash.png"
  39 border="1">
  40
  41 <p>
  42 By default, Tor is configured to run at startup.  If you do not want Tor to
  43 run on startup, you can disable this by selecting "Customize" in the
  44 Installer, and then un-checking the "Tor Startup Script" box. Be sure to
  45 leave the other boxes checked.
  46 </p>
  47
  48 <p>Once the installer is finished and your computer restarts, Tor will
  49 start automatically.  Tor comes configured as a client by default. It
  50 uses a built-in default configuration file in <tt>/Library/Tor/torrc</tt>,
  51 but most people won't need to change any of the settings. Tor is now
  52 installed.</p>
  53
  54 <p>Privoxy is installed as part of the Tor bundle package
  55 installer. Privoxy is a filtering web proxy that integrates well with
  56 Tor. Once it's installed, it will start automatically when your computer
  57 is restarted.
  58 </p>
  59
  60 <p>You do not need to configure Privoxy to use Tor. A custom Privoxy
  61 configuration for Tor has been installed as part of the installer package.
  62 </p>
  63
  64 <a name="using"></a>
  65 <h2>Step Two: Configure your applications to use Tor</h2>
  66
  67 <p>After installing Tor, you need to configure your applications to use
  68 it. The first step is to set up web browsing.
  69 Change your browser to HTTP proxy at localhost port 8118.
  70 (That's where Privoxy listens.)
  71 In Mozilla, this is in Mozilla|Preferences|Advanced|Proxies.
  72 In Firefox it's Firefox|Preferences|General|ConnectionSettings.
  73 You should set both your Web Proxy (HTTP) and your Secure Web Proxy
  74 (HTTPS or SSL) to localhost port 8118, to hide your SSL traffic too.
  75
  76 <p>If you want to use Tor with Safari, you need to change your
  77 Network Settings. The process looks something like:</p>
  78
  79 <img alt="LAN settings in IE"
  80 src="http://tor.eff.org/img/screenshot-osx-choose-network.png"
  81 border="1">
  82
  83 <p>
  84 Select your Network Preferences from the Apple | Location menu.</p>
  85
  86 <img alt="Proxy settings in IE"
  87 src="http://tor.eff.org/img/screenshot-osx-choose-interface.png"
  88 border="1">
  89 <P>
  90
  91 <p>Select the Network Interface you want to enable Tor on. If you use
  92 more than one Interface you must change the proxy settings for each
  93 individually.</p>
  94
  95 <img alt="Proxy settings in IE"
  96 src="http://tor.eff.org/img/screenshot-osx-proxy-settings.png"
  97 border="1">
  98
  99 <p>Select and enter localhost and port 8118 for both Web Proxy (HTTP)
 100 and your Secure Web Proxy (HTTPS)</p>
 101
 102 <p>Using privoxy is <strong>necessary</strong> because <a
 103 href="http://tor.eff.org/cvs/tor/doc/CLIENTS">browsers leak your
 104 DNS requests when they use a SOCKS proxy directly</a>, which is bad for
 105 your anonymity. Privoxy also removes certain dangerous headers from your
 106 web requests, and blocks obnoxious ad sites like Doubleclick.</p>
 107
 108 <p>To test if it's working, go to
 109 <a href="http://peertech.org/privacy-knoppix/">peertech</a>,
 110 <a href="http://www.junkbusters.com/cgi-bin/privacy">junkbusters</a>,
 111 <a href="http://www.network-tools.com">network-tools</a> or
 112 <a href="http://ipid.shat.net">ipid</a>
 113 and see what IP it says you're coming from.
 114 </p>
 115
 116 <p>
 117 If you have a personal firewall that limits your computer's ability
 118 to connect to itself, be sure to allow connections from your local
 119 applications to
 120 local port 8118 and port 9050. If your firewall blocks outgoing connections,
 121 punch a hole so it can connect to at least TCP ports 80, 443, and 9001-9033.
 122 For more troubleshooting suggestions, see <a
 123 href="http://wiki.noreply.org/wiki/TheOnionRouter/TorFAQ">the FAQ</a>.
 124 </p>
 125
 126 <p>To Torify another application that supports HTTP, just point
 127 it at Privoxy (that is, localhost port 8118). To use SOCKS
 128 directly (for example, for instant messaging, Jabber, IRC, etc),
 129 point your application directly at Tor (localhost port 9050). For
 130 applications that support neither SOCKS nor HTTP, take a look at <a
 131 href="http://www.taiyo.co.jp/~gotoh/ssh/connect.html">connect</a> or
 132 <a href="http://www.dest-unreach.org/socat/">socat</a>.
 133 <br />
 134 For more information how to Torify other applications in detail visit
 135 the <a href="http://wiki.noreply.org/wiki/TheOnionRouter/TorifyHOWTO">Torify HOWTO</a>.
 136 <p>If you have suggestions for improving this document, please post
 137 them on <a href="http://bugs.noreply.org/tor">our bugtracker</a> in the
 138 website category. Thanks!</p>
 139
 140 </body>
 141 </html>
 142