doc/tor-doc-osx.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
   2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
   3
   4 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
   5 <head>
   6   <title>Tor Mac OS X Install Instructions</title>
   7   <meta name="Author" content="Roger Dingledine" />
   8   <meta name="Author" content="Thomas Hardly" />
   9   <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
  10   <link rel="stylesheet" type="text/css" href="http://tor.eff.org/stylesheet.css" />
  11   <link rel="shortcut icon" type="image/x-icon" href="/favicon.ico" />
  12 </head>
  13
  14 <body>
  15
  16 <!-- TITLE BAR & NAVIGATION -->
  17
  18 <table class="banner" border="0" cellpadding="0" cellspacing="0">
  19     <tr>
  20         <td class="banner-left"></td>
  21         <td class="banner-middle">
  22             <a href="/index.html">Home</a>
  23           | <a href="/howitworks.html">How It Works</a>
  24           | <a href="/download.html">Download</a>
  25           | <a href="/documentation.html">Docs</a>
  26           | <a href="/users.html">Users</a>
  27           | <a href="/faq.html">FAQs</a>
  28           | <a href="/volunteer.html">Volunteer</a>
  29           | <a href="/developers.html">Developers</a>
  30           | <a href="/research.html">Research</a>
  31           | <a href="/people.html">People</a>
  32         </td>
  33         <td class="banner-right"></td>
  34     </tr>
  35 </table>
  36
  37 <!-- END TITLE BAR & NAVIGATION -->
  38
  39 <div class="center">
  40
  41 <div class="main-column">
  42
  43 <h1>Running the <a href="http://tor.eff.org/">Tor</a> client on Mac OS X</h1>
  44 <br />
  45
  46 <p>
  47 <b>Note that these are the installation instructions for running a Tor client on
  48   Mac OS X. If you want to configure it as a server (please do), read the <a
  49   href="tor-doc-server.html">Configuring a server</a> guide.</b>
  50 </p>
  51
  52 <hr />
  53 <a id="installing"></a>
  54 <h2><a class="anchor" href="#installing">Step One: Download and Install Tor</a></h2>
  55 <br />
  56
  57 <p>
  58 The latest stable release of Tor for Macintosh OS X is <a
  59 href="http://tor.eff.org/dist/osx/Tor 0.1.0.15 Bundle.dmg">0.1.0.15</a>.
  60 Download it by clicking the link. You may be able to find experimental versions
  61 <a href="http://tor.freehaven.net/dist/osx/">here</a>, if you're looking for
  62 new features and new bugs.
  63 </p>
  64
  65 <p>Our Tor installer should make everything pretty simple. Below is a
  66 screenshot of the setup page:
  67 </p>
  68
  69 <img alt="tor installer splash page"
  70 src="http://tor.eff.org/img/screenshot-osx-installer-splash.png"
  71 border="1">
  72
  73 <p>
  74 By default, Tor is configured to run at startup.  If you do not want Tor to
  75 run on startup, you can disable this by selecting "Customize" in the
  76 Installer, and then un-checking the "Tor Startup Script" box. Be sure to
  77 leave the other boxes checked.
  78 </p>
  79
  80 <p>Once the installer is finished and your computer restarts, Tor will
  81 start automatically.  Tor comes configured as a client by default. It
  82 uses a built-in default configuration file in <tt>/Library/Tor/torrc</tt>,
  83 but most people won't need to change any of the settings. Tor is now
  84 installed.</p>
  85
  86 <p>Privoxy is installed as part of the Tor bundle package
  87 installer. Privoxy is a filtering web proxy that integrates well with
  88 Tor. Once it's installed, it will start automatically when your computer
  89 is restarted.
  90 </p>
  91
  92 <p>You do not need to configure Privoxy to use Tor. A custom Privoxy
  93 configuration for Tor has been installed as part of the installer package.
  94 </p>
  95
  96 <hr />
  97 <a id="using"></a>
  98 <h2><a class="anchor" href="#using">Step Two: Configure your applications to use Tor</a></h2>
  99 <br />
 100
 101 <p>After installing Tor and Privoxy, you need to configure your
 102 applications to use them. The first step is to set up web browsing.</p>
 103
 104 <p>If you're using Firefox (we recommend it), check out our <a
 105 href="tor-switchproxy.html">Tor SwitchProxy howto</a> to set up
 106 a plugin that makes it easy to switch between using Tor and using a
 107 direct connection.</p>
 108
 109 <p>Otherwise, you need to manually configure your browser to HTTP proxy
 110 at localhost port 8118.
 111 (That's where Privoxy listens.)
 112 In Mozilla, this is in Mozilla|Preferences|Advanced|Proxies.
 113 You should set both your Web Proxy (HTTP) and your Secure Web Proxy
 114 (HTTPS or SSL) to localhost port 8118, to hide your SSL traffic too.
 115 You should consider configuring your "FTP Proxy" too; see <a
 116 href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#FtpProxy">this
 117 note</a> about Tor and ftp proxies.
 118 </p>
 119
 120 <p>If you want to use Tor with Safari, you need to change your
 121 Network Settings. Select your Network Preferences from the Apple |
 122 Location menu:</p>
 123
 124 <img alt="Network settings"
 125 src="http://tor.eff.org/img/screenshot-osx-choose-network.png"
 126 border="1">
 127
 128 <p>Select the Network Interface on which you want to enable Tor. If you use
 129 more than one Interface you must change the proxy settings for each
 130 individually.</p>
 131
 132 <img alt="Network preferences"
 133 src="http://tor.eff.org/img/screenshot-osx-choose-interface.png"
 134 border="1">
 135 <p>
 136
 137 <p>Select and enter 127.0.0.1 and port 8118 for both
 138 Web Proxy (HTTP) and your Secure Web Proxy (HTTPS).
 139 You should also do this for "FTP Proxy" and "Gopher Proxy"; see <a
 140 href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#FtpProxy">this
 141 note</a> about Tor and ftp proxies. Leave your Use Passive FTP Mode
 142 (PASV) setting as is.</p>
 143
 144 <img alt="Proxy settings"
 145 src="http://tor.eff.org/img/screenshot-osx-proxy-settings.png"
 146 border="1">
 147
 148 <p>Using privoxy is <strong>necessary</strong> because <a
 149 href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#SOCKSAndDNS">browsers
 150 leak your
 151 DNS requests when they use a SOCKS proxy directly</a>, which is bad for
 152 your anonymity. Privoxy also removes certain dangerous headers from your
 153 web requests, and blocks obnoxious ad sites like Doubleclick.</p>
 154
 155 <p>To Torify other applications that support HTTP proxies, just
 156 point them at Privoxy (that is, localhost port 8118). To use SOCKS
 157 directly (for instant messaging, Jabber, IRC, etc), you can point
 158 your application directly at Tor (localhost port 9050), but see <a
 159 href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#SOCKSAndDNS">this
 160 FAQ entry</a> for why this may be dangerous. For applications
 161 that support neither SOCKS nor HTTP, take a look at <a
 162 href="http://www.taiyo.co.jp/~gotoh/ssh/connect.html">connect</a> or
 163 <a href="http://www.dest-unreach.org/socat/">socat</a>.</p>
 164
 165 <p>For information on how to Torify other applications, check out the
 166 <a href="http://wiki.noreply.org/wiki/TheOnionRouter/TorifyHOWTO">Torify
 167 HOWTO</a>.
 168 </p>
 169
 170 <hr />
 171 <a id="verify"></a>
 172 <h2><a class="anchor" href="#verify">Step Three: Make sure it's working</a></h2>
 173 <br />
 174
 175 <p>
 176 <a href="http://ipid.shat.net">ipid.shat.net</a> and
 177 <a href="http://www.showmyip.com/">showmyip.com</a>
 178 are sites that show what IP address and country you appear to be coming
 179 from.
 180 </p>
 181
 182 <p>If you don't know your current public IP address, this may not be a
 183 very useful test. To learn your IP address, run "<tt>ifconfig</tt>".
 184 If you are behind a NAT or firewall, though, you won't be able
 185 to learn your public IP address. In this case, you should 1) configure
 186 your browser to connect directly (that is, stop using Privoxy), 2) check
 187 your IP address with one of the sites above, 3) point your browser back
 188 to Privoxy, and 4) see whether your IP address has changed.
 189 </p>
 190
 191 <p>If you have a personal firewall that limits your computer's
 192 ability to connect to itself, be sure to allow connections from
 193 your local applications to local port 8118 and port 9050. If
 194 your firewall blocks outgoing connections, punch a hole so
 195 it can connect to at least TCP ports 80 and 443, and then see <a
 196 href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#FirewalledClient">this
 197 FAQ entry</a>.
 198 </p>
 199
 200 <p>If it's still not working, look at <a
 201 href="http://wiki.noreply.org/noreply/TheOnionRouter/TorFAQ#ItDoesntWork">this
 202 FAQ entry</a> for hints.</p>
 203
 204 <hr />
 205 <a id="server"></a>
 206 <h2><a class="anchor" href="#server">Step Four: Configure it as a server</a></h2>
 207 <br />
 208
 209 <p>The Tor network relies on volunteers to donate bandwidth. The more
 210 people who run servers, the faster the Tor network will be. If you have
 211 at least 20 kilobytes/s each way, please help out Tor by configuring your
 212 Tor to be a server too. We have many features that make Tor servers easy
 213 and convenient, including rate limiting for bandwidth, exit policies so
 214 you can limit your exposure to abuse complaints, and support for dynamic
 215 IP addresses.</p>
 216
 217 <p>Having servers in many different places on the Internet is what
 218 makes Tor users secure. You may also get stronger anonymity yourself,
 219 since remote sites can't know whether connections originated at your
 220 computer or were relayed from others.</p>
 221
 222 <p>Read more at our <a href="tor-doc-server.html">Configuring a server</a>
 223 guide.</p>
 224
 225 <hr />
 226 <a id="uninstall"></a>
 227 <h2><a class="anchor" href="#uninstall">How To Uninstall Tor and Privoxy</a></h2>
 228 <br />
 229
 230 <p>The Tor 0.1.0.x series does not come with an uninstaller; this feature
 231   will be added in the 0.1.1.x series.  If you want to remove Tor on OSX,
 232   here's how:</p>
 233
 234 <p>Change your application proxy settings back to their original values.
 235    If you just want to stop using Tor, you can end at this point.</p>
 236
 237 <p>To stop Tor and Privoxy from running on startup</b>, remove the
 238    /Library/StartupItems/Tor and /Library/StartupItems/Privoxy directories
 239    respectively. If you just want to stop Tor from running, you can end at this
 240    point.</p>
 241
 242 <p>To erase all remaining Tor and Privoxy files from your computer, delete
 243   the following:
 244    <ul>
 245    <li>/Library/Tor</li>
 246    <li>/Library/Privoxy</li>
 247    <li>/usr/bin/tor</li>
 248    <li>/usr/bin/tor_resolve</li>
 249    <li>/var/log/tor</li>
 250    <li>/usr/share/man/man1/tor.1</li>
 251    <li>/usr/share/man/man1/tor-resolve.1</li>
 252    <li>/usr/share/man/man1/torify.1</li>
 253    <li>/Library/Receipts/Privoxy.pkg/</li>
 254    <li>/Library/Receipts/privoxyconf.pkg/</li>
 255    <li>/Library/Receipts/Tor.pkg/</li>
 256    <li>/Library/Receipts/torstartup.pkg/</li>
 257   </ul>
 258 </p>
 259
 260 <hr />
 261
 262 <p>If you have suggestions for improving this document, please post
 263 them on <a href="http://bugs.noreply.org/tor">our bugtracker</a> in the
 264 website category. Thanks!</p>
 265
 266   </div><!-- #main -->
 267 </div>
 268   <div class="bottom" id="bottom">
 269      <i><a href="mailto:tor-webmaster@freehaven.net"
 270      class="smalllink">Webmaster</a></i> - $Id$
 271   </div>
 272 </body>
 273 </html>
 274