Tor Browser: Manual Download

From Whonix
Jump to navigation Jump to search


Refresh-525698640.png

Introduction[edit]

  • Non-Whonix ™ Platforms: If Firefox is available and Tor Browser is to be installed on a non-Whonix ™ platform, proceed to Download and Install Tor Browser. Otherwise, first install Firefox on the respective platform and configure the setting for clearnet onion connections, if desired.
  • Whonix ™: If Tor Browser is not installed, then it can be downloaded by using Firefox-ESR. Only complete this action for downloading Tor Browser and nothing else.

Manually Downloading Tor Browser[edit]

Install Firefox-ESR Web Browser[edit]

1. If a functional browser is already available, this browser installation chapter can be skipped.

2. Note: Firefox-ESR is used as en example here. Any browser should work.

3. Install Firefox-ESR.

In Whonix-Workstation ™ Konsole, run.

sudo apt install firefox-esr

4. Optional: Configure clearnet onion service connections.

If users intend to connect to the Tor Project's onion service to download Tor Browser, then adjust the following Firefox-ESR setting to permit these connections.

In Firefox address bar: about:configI accept the risk!network.dns.blockDotOniontoggle to false.

Download and Install Tor Browser[edit]

[1]

Ambox notice.png Qubes-Whonix ™ note:

  • App Qube: The following instructions should be run in anon-whonix.
  • Template: Tor Browser upgrades in the whonix-ws-16 Template are only inherited by newly created App Qube. In addition, Tor Browser must be stored in folder /var/cache/tb-binary/.tb rather than in folder /home/user/.tb. For further information, see Qubes-specific Tor Browser issues.
  1. Make sure folder /home/user/.tb exists.
    mkdir --parents /home/user/.tb
  2. Navigate to https://www.torproject.org/download/ (.onion) and download Tor Browser and the associated file signature (.asc). Store it in folder /home/user/.tb.
  3. Read https://support.torproject.org/tbb/how-to-verify-signature/ and learn how to perform digital software signature verification ("gpg"). Download and import the necessary keys.
  4. Perform digital software signature verification for the Tor Browser download.
  5. Navigate to folder /home/user/.tb with a file manger. Dolphin example: DolphinViewShow Hidden Files
  6. If the old version of Tor Browser is still open, close it.
  7. If there already is a folder /home/user/.tb/tor-browser, rename the old /home/user/.tb/tor-browser to something else.
  8. Extract Tor Browser: Right-click on the downloaded archiveextractextract archive here
  9. The process is complete.
  10. To start Tor Browser: [2]
  • If intending to use a graphical user interface: Start Tor Browser from the start menu.
  • If intending to use a terminal, run the following command.

torbrowser

Footnotes[edit]

  1. Note on platform support: Qubes-Whonix ™ and Non-Qubes-Whonix ™ users should use the 64-bit version.
  2. Note this will not result in a Tor over Tor scenario when using Tor Browser. Whonix ™ has a mechanism to disable Tor stacking.