docs/en/tor-doc-osx.wml
2a9aaa80
 ## translation metadata
40e07e2e
 # Revision: $Revision$
2a9aaa80
 # Translation-Priority: 2-medium
 
 #include "head.wmi" TITLE="Tor Project: Mac OS X Install Instructions" CHARSET="UTF-8"
 <div id="content" class="clearfix">
   <div id="breadcrumbs">
b289ef06
     <a href="<page index>">Home &raquo; </a>
2a9aaa80
     <a href="<page docs/documentation>">Documentation &raquo; </a>
     <a href="<page docs/tor-doc-osx>">Mac OS X Client</a>
27c5c153
   </div>
2a9aaa80
   <div id="maincol">
11a3e8da
     <h1>Running Tor on Mac OS X</h1>
ed5ac546
     <br>
27c5c153
 
11a3e8da
     <h2>These are advanced installation instructions for running
     Tor in a command line. The recommended way to use Tor is to simply download the
73ba951c
     <a href="<page projects/torbrowser>">Tor Browser</a> and you
97631f6c
     are done.
     </h2>
27c5c153
 
5bd3add6
     <p>Even though Tor Browser comes with a regular Tor, it will only run
     as long as you keep Tor Browser open. The following instructions will
9fcd16f2
     set up Tor without graphical interface or a browser. Many people prefer
32316cbf
     this over TBB when they host onion services or relay traffic for other Tor
9fcd16f2
     users.  <hr>
2a9aaa80
     <a id="installing"></a>
76331607
     <h2><a class="anchor" href="#installing">Step One: Install a package manager</a></h2>
ed5ac546
     <br>
27c5c153
 
8dc3ae19
     <p>There are two package manager on OS X: Homebrew and Macports. You can use the package manager of your choice.</p>
 
2a9aaa80
     <p>
8dc3ae19
     To install Homebrew follow the instructions on <a
     href="https://brew.sh/">brew.sh</a>.
     </p>
 
     <p>
     To install Macports follow the instructions on <a
     href="https://www.macports.org/install.php">macports.org/install.php</a>.
2a9aaa80
     </p>
27c5c153
 
ed5ac546
     <hr>
11a3e8da
     <h2>Step Two: Install Tor</a></h2>
ed5ac546
     <br>
27c5c153
 
3fb99338
     <p>If you are using Homebrew in a Terminal window, run:</p>
8dc3ae19
 
     <pre>brew install tor</pre>
 
     <p>You will find a sample Tor configuration file at
     <tt>/usr/local/etc/tor/torrc.sample</tt>. Remove the .sample extension to
     make it effective.</p>
 
     <p>If you are using Macports in a Terminal window, run:</p>
11a3e8da
 
9fcd16f2
     <pre>sudo port install tor</pre>
27c5c153
 
9fcd16f2
     <p>You will find a sample Tor configuration file at
     <tt>/opt/local/etc/tor/torrc.sample</tt>. Remove the .sample extension to
     make it effective.</p>
11a3e8da
 
     <hr>
27c5c153
     <a id="using"></a>
9fcd16f2
     <h2><a class="anchor" href="#using">Step Three: Configure your application to use Tor</a></h2>
27c5c153
 
11a3e8da
     <p>
9fcd16f2
     To use SOCKS directly (for instant messaging, Jabber, IRC, etc), you can
     point your application directly at Tor (localhost port 9050), but see <a
     href="<wikifaq>#SOCKSAndDNS">this FAQ entry</a> for why this may be
     dangerous. For applications that support neither SOCKS nor HTTP, take a
     look at <a href="http://www.dest-unreach.org/socat/">socat</a>.</p>
27c5c153
 
2a9aaa80
     <p>For information on how to Torify other applications, check out the
81720f6d
     <a href="<wiki>doc/TorifyHOWTO">Torify HOWTO</a>.
2a9aaa80
     </p>
27c5c153
 
9fcd16f2
     <p>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 9050. If your firewall blocks outgoing
     connections, punch a hole so it can connect to at least TCP ports 80 and
     443, and then see <a href="<wikifaq>#FirewalledClient">this FAQ entry</a>.
2a9aaa80
     </p>
27c5c153
 
2a9aaa80
     <p>If it's still not working, look at <a
481ccca3
     href="<page docs/faq>#DoesntWork">this FAQ entry</a> for hints.</p>
27c5c153
 
2a9aaa80
     <p>
99a04c3b
     Once it's working, learn more about <a href="<page
     download/download>#Warning">what Tor does and does not offer</a>.
2a9aaa80
     </p>
27c5c153
 
ed5ac546
     <hr>
2a9aaa80
     <a id="server"></a>
     <a id="relay"></a>
11a3e8da
     <h2><a class="anchor" href="#relay">Configure Tor as a relay</a></h2>
ed5ac546
     <br>
27c5c153
 
8d10ea8d
     <p>The Tor network relies on volunteers to donate bandwidth. If you
     want to help <strong>make the Tor network faster</strong>, please
     consider <a href="<page docs/tor-doc-relay>">running a relay</a>.</p>
27c5c153
 
ed5ac546
     <hr>
2a9aaa80
     <a id="uninstall"></a>
76331607
     <h2><a class="anchor" href="#uninstall">How to uninstall Tor</a></h2>
ed5ac546
     <br>
11a3e8da
 
99a04c3b
     <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>
27c5c153
 
9fcd16f2
     <p>If you want to completely remove Tor, type into a Terminal window:</p>
27c5c153
 
9fcd16f2
     <pre>sudo port uninstall tor</pre>
27c5c153
 
2a9aaa80
   </div>
   <!-- END MAINCOL -->
   <div id = "sidecol">
 #include "side.wmi"
 #include "info.wmi"
   </div>
   <!-- END SIDECOL -->
 </div>
 <!-- END CONTENT -->
27c5c153
 #include <foot.wmi>