## translation metadata
# Revision: $Revision$
# 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">
    <a href="<page index>">Home &raquo; </a>
    <a href="<page docs/documentation>">Documentation &raquo; </a>
    <a href="<page docs/tor-doc-osx>">Mac OS X Client</a>
  </div>
  <div id="maincol">
    <h1>Running Tor on Mac OS X</h1>
    <br>

    <h2>These are advanced installation instructions for running
    Tor in a command line. The recommended way to use Tor is to simply download the
    <a href="<page projects/torbrowser>">Tor Browser</a> and you
    are done.
    </h2>

    <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
    set up Tor without graphical interface or a browser. Many people prefer
    this over TBB when they host onion services or relay traffic for other Tor
    users.  <hr>
    <a id="installing"></a>
    <h2><a class="anchor" href="#installing">Step One: Install a package manager</a></h2>
    <br>

    <p>There are two package manager on OS X: Homebrew and Macports. You can use the package manager of your choice.</p>

    <p>
    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>.
    </p>

    <hr>
    <h2>Step Two: Install Tor</a></h2>
    <br>

    <p>If you are using Homebrew in a Terminal window, run:</p>

    <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>

    <pre>sudo port install tor</pre>

    <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>

    <hr>
    <a id="using"></a>
    <h2><a class="anchor" href="#using">Step Three: Configure your application to use Tor</a></h2>

    <p>
    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>

    <p>For information on how to Torify other applications, check out the
    <a href="<wiki>doc/TorifyHOWTO">Torify HOWTO</a>.
    </p>

    <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>.
    </p>

    <p>If it's still not working, look at <a
    href="<page docs/faq>#DoesntWork">this FAQ entry</a> for hints.</p>

    <p>
    Once it's working, learn more about <a href="<page
    download/download>#Warning">what Tor does and does not offer</a>.
    </p>

    <hr>
    <a id="server"></a>
    <a id="relay"></a>
    <h2><a class="anchor" href="#relay">Configure Tor as a relay</a></h2>
    <br>

    <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>

    <hr>
    <a id="uninstall"></a>
    <h2><a class="anchor" href="#uninstall">How to uninstall Tor</a></h2>
    <br>

    <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>If you want to completely remove Tor, type into a Terminal window:</p>

    <pre>sudo port uninstall tor</pre>

  </div>
  <!-- END MAINCOL -->
  <div id = "sidecol">
#include "side.wmi"
#include "info.wmi"
  </div>
  <!-- END SIDECOL -->
</div>
<!-- END CONTENT -->
#include <foot.wmi>
