documentation/site/source/guides/device-guides/mac/tor-mac.rst

.. _tor-mac:

==================
Running Tor on Mac
==================

Install Homebrew
----------------

#. If you do not have Homebrew installed, follow the installation instructions `here <https://brew.sh/>`_.  TLDR: Open the Terminal and paste the following line:

    .. code-block:: bash

        /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

#. You will be prompted for your system password before installation; proceed with entering your password.  You may be asked more than once.

    .. figure:: /_static/images/tor/install_homebrew.png
        :width: 80%
        :alt: Homebrew installation

#. You will be notified which directories Homebrew is going to create, hit :code:`RETURN`:

    .. figure:: /_static/images/tor/install_homebrew1.png
        :width: 80%
        :alt: Homebrew installation

    Homebrew creates the directories and downloads any other files it needs e.g. “Command Line Tool for Xcode” and “Homebrew”.

    Wait a few minutes while it downloads and installs what it needs.

.. note:: Once installation is complete you will need to add "brew" to your path. There will be instructions on how to do this with the specific commands you need to enter if you scroll up a little in your terminal. Look for "Add homebrew to your path". Enter the commands and then type **brew --version** to ensure that brew is working. If you see something like **"Homebrew 3.6.18"** then it is installed. If you see **"zsh: command not found: brew"** then it either hasn't installed correctly, has not been added to your path yet or you simply need to open a new terminal. (If you do try restarting terminal, make a note of the commands suggested in case you need them again).

.. warning:: Surprisingly, Homebrew uses Google Analytics to collect anonymous usage data. You can deselect the option to share usage data by `opting out <https://docs.brew.sh/Analytics#opting-out>`_.

Install Tor
-----------

.. caution:: If you have the Tor Browser open, close it and quit the application.

.. note:: If you are on a very old version of macOS, such as High Sierra (10.13) or below, first execute this command in a Terminal window:

    .. code-block::

        echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bash_profile
    
    Then close the Terminal.

#. Open a new Terminal and install Tor using the following command:

    .. code-block:: bash

        brew install tor


#. Then run Tor with:

    .. code-block:: bash

        brew services start tor

This will start Tor and ensure that it is always running, even after a restart.  See the `Tor Project docs <https://2019.www.torproject.org/docs/tor-doc-osx.html.en>`_ for more details.

Enable Tor System-wide
----------------------

.. tabs::

    .. group-tab:: Ventura

        #. Enable proxy autoconfig file (This will download the Start9 standard proxy config file. You can use your own if you prefer):

            .. code-block:: bash

                sudo curl https://start9.com/assets/proxy.pac --output /Library/WebServer/Documents/proxy.pac

        #. Now enable apache service:

            .. code-block:: bash
        
                sudo launchctl load -w /System/Library/LaunchDaemons/org.apache.httpd.plist

        #. Go to System Settings:

            .. figure:: /_static/images/tor/systemSettings.png
                :width: 40%
                :alt: System Preferences

        #. Click on *Network* and then select the interface on which you wish to enable Tor system-wide (both Ethernet and WiFi advised - do one then the other):

            .. figure:: /_static/images/tor/ventura-settings.png
                :width: 80%
                :alt: Select Network

        #. Click *Details*:

            .. figure:: /_static/images/tor/ventura-network-advanced.png
                :width: 80%
                :alt: Click Advanced

        #. Click "Proxies," then select "Automatic Proxy Configuration," add this URL: ``http://localhost/proxy.pac``, then click "OK":

            .. figure:: /_static/images/tor/ventura-proxies-corrected.png
                :width: 80%
                :alt: Select Proxys

        Done! You have now enabled system-wide Tor potential.

        We advise going back to step 4 and repeating this for Wifi/Ethernet depending on which interface you haven't done yet.

        If you ever need to view the status of the tor service, enter the following into a Terminal:

            .. code-block:: bash
                
                cat /usr/local/var/log/tor.log || sudo cat /opt/homebrew/var/log/tor.log

        If you'd like to setup Firefox to use Tor you can follow  :ref:`this guide<ff-mac>`.

    .. group-tab:: Pre-Ventura

        #. Enable proxy autoconfig file (This will download the Start9 standard proxy config file. You can use your own if you prefer):

            .. code-block:: bash

                sudo curl https://start9.com/assets/proxy.pac --output /Library/WebServer/Documents/proxy.pac

        #. Now enable apache service:

            .. code-block:: bash
        
                sudo launchctl load -w /System/Library/LaunchDaemons/org.apache.httpd.plist

        #. Go to System Preferences:

            .. figure:: /_static/images/tor/systemprefs.png
                :width: 40%
                :alt: System Preferences

        #. Click on Network:

            .. figure:: /_static/images/tor/network.png
                :width: 80%
                :alt: Select Network

        #. In this example, we'll select WiFi on the left panel. If you're using Ethernet, click that instead. Next click "Advanced" (We suggest returning to this step in order to do both Ethernet AND WiFi):

            .. figure:: /_static/images/tor/wifi_click_advanced.png
                :width: 80%
                :alt: Click Advanced

        #. Select "Proxies":

            .. figure:: /_static/images/tor/proxys.png
                :width: 80%
                :alt: Select Proxys

        #. Select "Automatic Proxy Configuration", add this URL: **http://localhost/proxy.pac** then click "OK"

            .. figure:: /_static/images/tor/entertorproxyURL-pre-ventura.png
                :width: 80%
                :alt: Select Automatic proxy config and enter URL

        #. Finally, click "Apply"

            .. figure:: /_static/images/tor/applyproxy.png
                :width: 80%
                :alt: Apply proxy

        Done! You have now enabled system-wide Tor potential.

        We suggest heading back to step 5 and enabling Tor system-wide on Ethernet/WiFi now - whichever you did not do already.

        If you ever need to view the status of the tor service, enter the following into a Terminal:

            .. code-block:: bash
                
                cat /usr/local/var/log/tor.log || sudo cat /opt/homebrew/var/log/tor.log

        If you'd like to setup Firefox to use Tor you can follow  :ref:`this guide<ff-mac>`.