Last update: March 17, 2019. This website uses cookies. By using our website, you acknowledge that you have read, understood and agreed to our Privacy Policy, Cookie Policy, Terms of Service, and E-Sign Consent. More information



Qubes Tor Browser Update

Unfortunately, updating Tor Browser is more complex than regular system updates due to technical limitations outside of Whonix's control. [1] Applying the following instructions makes it is possible to keep Tor Browser up to date at all times.

New AppVMs and DisposableVMs[edit]

In Qubes-Whonix, Tor Browser Downloader by Whonix (update-torbrowser) is automatically run when the Whonix-Workstation TemplateVM (whonix-ws-14) package tb-updater is updated. Therefore, running Tor Browser Downloader by Whonix inside the TemplateVM (whonix-ws-14) ensures that new AppVMs and DispVMs are created with a copy of the latest Tor Browser version.

If the Tor Browser Downloader by Whonix package tb-updater has not been updated yet, users are advised to manually run it in the Whonix-Workstation TemplateVM (whonix-ws-14). For instructions, see Tor Browser Downloader by Whonix.

DVM Template[edit]

For further information on installing, updating and using Tor Browser in Qubes DispVMs, see: How to use DisposableVMs in Qubes-Whonix.

Existing AppVMs[edit]

Follow these steps to update Tor Browser in an existing Whonix-Workstation AppVM such as anon-whonix:

  1. Start Tor Browser: Qubes Start Menu -> Whonix-Workstation AppVM (commonly called anon-whonix) -> Tor Browser
  2. Use Tor Browser Internal Updater.
    1. Tor_Browser/Advanced_Users#Technical_Background_of_Tor_Browser_Update_Process_Cumbersomeness
    2. It is possible to run Tor Browser Downloader by Whonix inside a DispVM as well -- probably easiest using Tor_Browser#Tor Browser Internal Updater -- and then restart Tor Browser. However, these updates will not persist due to the DispVM design.
    3. See tb-updater in Qubes Template VM for technical details.