Tor Browser: Manual Download

Whonix ®

Download

Windows Linux Mac VirtualBox KVM Qubes Intel / AMD64 ARM64 PPC64 USB ISO Raspberry Pi More options Source Code

About

Overview Features Whonix vs VPNs Why Open Source? Project Activities Contributors Mission & Vision

Docs

Documentation FAQ Troubleshooting

Community

Forums Forum Best Practices Contribute

Support

Self Support First Policy Search Engines, Docs and AI Support (Limited) Reporting Bugs Contact (Restricted)

Tools Upload file Special pages Recent changes Print Version Page meta What links here Related changes Page information

Page Read Edit History Move Protection Unwatch Watch Delete Purge

User Preferences Watchlist Contributions Logout Create account Login

Donate

Connections between Gateway and Workstation Advanced Documentation Ports Previous page: Connections between Gateway and Workstation Index page: Advanced Documentation Next page: Ports Tor Browser: Manual Download

Tor Browser is installed by default inside Whonix. It is usually updated using its own internal updater.

Tor Browser Downloader (by Whonix developers) can be used to re-install Tor Browser.

Manually downloading Tor Browser is also possible, which is documented on this wiki page. This might useful in case Tor Browser Downloader is ever broken.

Introduction

• 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

Install Firefox-ESR Web Browser

1. Is a functional browser already available?

• If yes: This browser installation chapter can be skipped.
• If no: A functional browser is recommended to be installed to able to follow further instructions.

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

3. Install Firefox-ESR.

In Whonix-Workstation^™ terminal, run.

Install package(s) firefox-esr following these instructions

1 Platform specific notice.

• Non-Qubes-Whonix: No special notice.
• Qubes-Whonix: In Template.

2 Update the package lists and upgrade the system.

sudo apt update && sudo apt full-upgrade

3 Install the firefox-esr package(s).

Using apt command line --no-install-recommends option is in most cases optional.

sudo apt install --no-install-recommends firefox-esr

4 Platform specific notice.

• Non-Qubes-Whonix: No special notice.
• Qubes-Whonix: Shut down Template and restart App Qubes based on it as per Qubes Template Modification.

5 Done.

The procedure of installing package(s) firefox-esr is complete.

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:config → I accept the risk! → network.dns.blockDotOnion → toggle to false.

5. Done.

Browser installation completed. Please proceed with instructions below.

Download and Install Tor Browser

Platform Specific Notice:

• Non-Qubes-Whonix^™: No special notice.
• Qubes-Whonix:
  • App Qube: The following instructions should be run in anon-whonix.
  • Template: Tor Browser upgrades in the whonix-workstation-17 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/ 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. Thunar example: Thunar → View → Show 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 archive → extract → extract archive here
9. The process is complete.
10. To start Tor Browser:

• A) If intending to use a graphical user interface: Start Tor Browser from the start menu.
• B) If intending to use a terminal, run the following command: torbrowser
• C) Starting Tor Browser directly without Tor Browser Starter (/usr/bin/torbrowser) by Whonix: ~/.tb/tor-browser/Browser/start-tor-browser
• D) Same as above in debug mode: ~/.tb/tor-browser/Browser/start-tor-browser --debug

Footnotes

Whonix The most watertight privacy operating system in the world.

Dark mode

Follow us on social media

Supported by Power Up Privacy

Whonix is proudly supported until 2025 by Power Up Privacy, a privacy advocacy group that seeks to supercharge privacy projects with resources so they can complete their mission of making our world a better place. (Strictly subject to our sponsorship policy.)

At Whonix we value freedom and trust, supporting Open Source and Freedom Software

By using this website, you acknowledge you have read, understood, and agree to be bound by these agreements: Terms of Service, Privacy Policy, Cookie Policy, E-Sign Consent, DMCA, Imprint 2012- 2025 ENCRYPTED SUPPORT LLC

Your support makes
all the difference!

We believe security software like Whonix needs to remain open source and independent. Would you help sustain and grow the project? Learn more about our 13 year success story and maybe DONATE!