.. include:: /urls.rst

.. _pureos_tips_tor:

Accessing the Tor network
=========================

.. _software_pureos_tips_tor_firefox:

Firefox
-------

#. Install ``tor`` if it not already installed on your system.
   Open a terminal emulator and run the following command:

   .. code-block:: bash

      sudo apt install tor

#. Open a terminal emulator and run the following command to enable and start the ``tor`` service:

   .. code-block:: bash

      sudo systemctl enable --now tor.service

#. Launch **Firefox** and open **Preferences**:

   .. image:: ../img/firefox-esr/settings-dropdown-preferences.png
      :scale: 50%
      :alt: Opening the Preferences menu in Firefox

#. Under the **General** tab, find **Network proxy** settings:

   .. image:: ../img/firefox-esr/network-proxy-settings.png
      :scale: 50%
      :alt: Firefox network proxy settings

#. Setup as shown:

   .. image:: ../img/firefox-esr/network-proxy-connection-settings.png
      :scale: 50%
      :alt: Firefox network proxy connection settings

#. Close the settings and open `<https://check.torproject.org/>`_ to see if you have access to the Tor network:

   .. image:: ../img/firefox-esr/tor-check.png
      :scale: 50%
      :alt: Firefox tor network test

.. tip::

   Tor authors strongly recommend that you install the :ref:`TorBrowser <software_pureos_tips_tor_install_torbrowser>` to help mitigate the practice of browser fingerprinting.


.. _software_pureos_tips_tor_install_torbrowser:

Installing TorBrowser
---------------------

.. note::
   Tor is not a "magic bullet" for privacy.
   Review the `Tor Project's instructions <https://www.torproject.org/download/download-easy.html.en#warning>`_ for more information about best practices.

#. Open **PureBrowser** and navigate to https://www.torproject.org/download/download-easy.html.en.
   Click to download the **Linux, 64-bit** version.
   Choose to save the file and click **OK**:

   .. image:: ../img/tor-browser/tor1.png
      :scale: 50%
      :alt: Saving the tor installation archive from within PureBrowser

#. When download is completed, click the folder icon to open the **Downloads** folder:

   .. image:: ../img/tor-browser/tor2.png
      :scale: 50%
      :alt: Opening the downloads directory within PureBrowser

#. Double-click the downloaded file to open it:

   .. image:: ../img/tor-browser/tor3.png
      :scale: 50%
      :alt: Opening the downloaded archive file

#. The file will be opened in archive manager.
   Click **Extract** to proceed:

   .. image:: ../img/tor-browser/tor4.png
      :scale: 50%
      :alt: Extracting the downloaded archive file

#. **Select the folder** where the archive will be extracted (in this example, the **Desktop** folder is used).
   Click the **Extract** button in the upper-right corner to unpack the archive:

   .. image:: ../img/tor-browser/tor5.png
      :scale: 50%
      :alt: Choosing the extraction path

#. When the extraction is complete, click to show the extracted files:

   .. image:: ../img/tor-browser/tor6.png
      :scale: 50%
      :alt: Viewing the contents of the downloaded archive

#. This is what you will see:

   .. image:: ../img/tor-browser/tor7.png
      :scale: 50%
      :alt: Selecting the start-tor-browser.desktop file

   The extracted folder is named ``tor-browser_en-US`` and that it is placed in the **Desktop** directory.
   The file ``start-tor-browser.desktop`` is a shortcut file.
   It must be edited to point to the directory where we extracted the TorBrowser archive.

#. Open a terminal emulator and navigate into the extracted folder.
   For example, if the file was extracted into the **Desktop** folder, run the following command:

   .. code-block:: bash

      cd ~/Desktop/tor-browser_en-US

#. Still within the terminal emulator, run the following command to have **Tor Browser** appear with your other installed apps:

   .. code-block:: bash

      ./start-tor-browser.desktop --register-app

#. You should see the following output:

   .. code-block:: bash

      user@Librem15-PureOS:~$ cd ~/Desktop/tor-browser_en-US
      user@Librem15-PureOS:~/Desktop/tor-browser_en-US$ ./start-tor-browser.desktop --register-app
      Launching './Browser/start-tor-browser --detach --register-app'...
      Tor Browser has been registered as a desktop app for this user in ~/.local/share/applications/

#. Launch TorBrowser.
   When it is configured, open `<https://check.torproject.org/>`_ to verify that you are using the Tor network:

   .. image:: ../img/tor-browser/tor17.png
      :scale: 50%
      :alt: TorBrowser connection verification

.. note::
   If you wish to upgrade TorBrowser, delete the ``tor-browser_en-US`` folder from your **Desktop** directory and repeat only the steps 1-6!

.. seealso::
   You can also setup a different :ref:`browser to access the Tor network <software_pureos_tips_tor_firefox>`.
   However, this is not recommended by the ``tor`` authors.