Manually Downloading Tor Browser
The Computer Security Education page contains a chapter recommending to learn the basics about torproject.org's Tor Browser before starting with Whonix.
For example, in past before the introduction of Tor Browser's Internal Updater, the recommended way by The Tor Project (TPO) to update Tor Browser was to rename your old folder (for example /home/user/tor-browser_en-US to something else) (or delete it) and to extract the newly downloaded version. You won't know about such glitches, if you don't know the basics, namely how to use Tor Browser on the host.
General questions like how verification of Tor Browser works, what that's good for etc. are off topic here, since we have to unfortunately regard this as basic knowledge. Whonix is not a standalone package in that sense and just has a small team while torproject.org has a much wider community and dedicated support staff. Again, you need to imagine you know nothing about Whonix and need to learn basics about Tor Browser in the first place.
If you are experiencing an issue with Tor Browser in Whonix (for example, some page does not load), please check first if you experience the same issue with Tor Browser on your host. If that is the case, Whonix is not responsible for this error. If you care to see the bug fixed, you are advised to search torproject.org's bug tracker and to open a bug upstream if no one else reported the issue yet. When upstream (TPO) fixes the issue, the issue will most likely also get fixed in Whonix.
Sometimes Whonix's Tor Browser Downloader breaks, because torproject.org changes the way Tor Browser can be downloaded/verified. Since Whonix's Tor Browser Downloader is maintained by the Whonix team, The Tor Project is not responsible for it and it and therefore should be discussed in Whonix's User Help Forum or Whonix's Bug Tracker.
At time of writing, there were never any errors in Tor Browser (such as when a page doesn't load) caused by Whonix.
Manually Downloading Tor Browser
If Tor Browser is not installed, then it can be downloaded by using Firefox-ESR, a web browser that is already installed by default in Whonix-Workstation. Use it to download Tor Browser only.
|Note: For Whonix 14, Firefox-ESR is no longer installed by default and requires manual installation via Whonix-Workstation Konsole.|
Install Firefox-ESR Web Browser
1. In Whonix-Workstation Konsole (Whonix 14 only!)
sudo apt-get install firefox-esr
2. If users intend to connect with Tor Project's .onion hidden service to download Tor Browser. A setting in Firefox-ESR requires editing before connections are permitted.
In Firefox address bar:
I accept the risk! ->
toggle to false.
Manually Download and Install Tor Browser
|Qubes users note:|
AppVMs: The following instructions are supposed to be run within Whonix-Workstation AppVMs (
1. Navigate to http://rqef5a5mebgq46y5.onion and download Tor Browser and the associated (.asc) file signature. Store it in /home/user/.tb.
2. Read http://expyuzz4wqqyqhjn.onion/docs/signing-keys.html to learn which PGP keys sign which packages.
3. Read http://expyuzz4wqqyqhjn.onion/docs/verifying-signatures.html and learn how to perform GPG verification. Download and import the necessary keys.
4. Verify the Tor Browser download.
5. Navigate to /home/user/.tb with the file manger. Dolphin example:
Show Hidden Files
6. If the old version of Tor Browser is still open, close it.
7. Rename the old /home/user/.tb/tor-browser to something else.
8. Extract the Tor Browser.
Right click on the downloaded archive ->
extract archive here
9. The process is complete.
10. To start it, navigate to the /home/user/.tb/tor-browser folder and double click start-tor-browser. 
|It should be clarified that this will not result in a Tor over Tor scenario when using Tor Browser. Whonix has a mechanism to disable Tor stacking.|
This is a wiki. Want to improve this page? Help is welcome and volunteer contributions are happily considered! See Conditions for Contributions to Whonix, then Edit! IP addresses are scrubbed, but editing over Tor is recommended. Edits are held for moderation.
- In addition, the user must store Tor Browser in /var/cache/tb-binary/.tb rather than /home/user/.tb. For further information, see Qubes-specific Tor Browser issues.
Note on platform support:
Or type in a terminal.