{{mbox | image = [[File:Ambox_warning_pn.svg.png|40px]] | text = Do not run Tor Browser in a Template ({{project_name_workstation_template}}) or Disposable Template ({{whonix-ws-dvm}})! }} Unfortunately, updating Tor Browser is more complex than regular system updates due to technical limitations outside of Whonix's control. [[Tor_Browser/Advanced_Users#Tor_Browser_Update:_Technical_Details|Tor Browser Update: Technical Details]] Apply the following instructions to keep Tor Browser up-to-date at all times. ==== New App Qubes and Disposables ==== In [[Qubes|{{q_project_name_long}}]], Tor Browser Downloader by {{project_name_short}} (update-torbrowser) automatically runs when the {{project_name_workstation_long}} Template ({{project_name_workstation_template}}) package tb-updater is updated. Therefore, running Tor Browser Downloader by {{project_name_short}} inside the Template ({{project_name_workstation_template}}) ensures that new App Qubes and [[Qubes/Disposables|Disposables]] are created with a copy of the latest Tor Browser version. If the Tor Browser Downloader by {{project_name_short}} package tb-updater has not been updated yet, it is advised to manually run it in the {{project_name_workstation_short}} Template ({{project_name_workstation_template}}). For instructions, see [[Tor_Browser#Tor_Browser_Downloader_by_{{project_name_short}}|Tor Browser Downloader by {{project_name_short}}]]. ==== Disposable Template ==== {{mbox | image = [[File:Ambox_warning_pn.svg.png|40px]] | text = Do not run Tor Browser Downloader by {{project_name_short}} inside the Disposable Template ({{whonix-ws-dvm}})! It should only be run in the Template ({{project_name_workstation_template}}) or in a {{project_name_workstation_template}}-based App Qube ({{project_name_workstation_vm}}). It is possible to run Tor Browser Downloader by {{project_name_short}} inside a Disposable as well -- probably easiest using [[Tor_Browser#Tor Browser Internal Updater|Tor Browser Internal Updater]] -- and then restart Tor Browser. However, these updates will not persist due to the Disposable design. See [[Tor_Browser/Advanced_Users#tb-updater_in_Qubes_Template|tb-updater in Qubes Template]] for technical details. }} For further information on installing, updating and using Tor Browser in Qubes Disposables, see: [[Qubes/Disposables|How to use Disposables in {{q_project_name_short}}]]. ==== Existing App Qubes ==== Follow these steps to update Tor Browser in an existing {{project_name_workstation_short}} App Qube such as {{project_name_workstation_vm}}: # Start Tor Browser: Qubes Start Menu → {{project_name_workstation_short}} App Qube (commonly called {{Code2|{{project_name_workstation_vm}}}}) → Tor Browser # Use [[Tor_Browser#Tor Browser Internal Updater|Tor Browser Internal Updater]]. ==== Summary ==== Tor Browser Downloader (by {{project_name_short}} developers): {{Code2|Tor Browser Downloader (by {{project_name_short}} developers)}} is useful to run inside: * {{project_name_workstation_short}} Template ({{project_name_workstation_template}}): to ensure that new App Qubes and [[Qubes/Disposables|Disposables]] are created with a copy of the latest Tor Browser version. * {{project_name_workstation_short}} App Qube ({{project_name_workstation_vm}}): to re-install the latest Tor Browser version in existing {{project_name_workstation_short}} App Qubes. {{Code2|Tor Browser Downloader (by {{project_name_short}} developers)}} is less useful if run inside: * Disposables: because upgrades won't persist {{Code2|Tor Browser Downloader (by {{project_name_short}} developers)}} should not be run in: * Disposable Template ({{whonix-ws-dvm}}) Tor Browser: {{Code2|Tor Browser}} is useful to run in: * {{project_name_workstation_short}} App Qube ({{project_name_workstation_vm}}) * Dispoables {{Code2|Tor Browser}} should not be run in: * {{project_name_workstation_short}} Template ({{project_name_workstation_template}}) * Disposable Template ({{whonix-ws-dvm}}) {{Header}} {{Footer}}