{{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}})! }} ==== Overview ==== 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. '''Table:''' ''Qubes VM Scenario and Instructions'' {| class="wikitable" ! Scenario ! Instructions |- ! {{Anchor|New App Qubes and Disposables}} 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}}]]. |- ! {{Anchor|Disposable Template}} 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}}) and/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}}]]. |- ! {{Anchor|Existing App Qubes}} 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}}: * '''A)''' Start Tor Browser: Qubes Start Menu → {{project_name_workstation_short}} App Qube (commonly called {{Code2|{{project_name_workstation_vm}}}}) → Tor Browser * '''B)''' Update Tor Browser: Use [[Tor_Browser#Tor Browser Internal Updater|Tor Browser Internal Updater]]. * '''C)''' Re-install Tor Browser: Use [[Tor_Browser#Tor_Browser_Downloader_by_Whonix|Tor Browser Downloader by Whonix developers]]. |- |} ==== Summary ==== '''Table:''' ''Comparison of Applications, Recommended and Discouraged Use'' {| class="wikitable" ! Tool ! Recommended Use ! Not Recommended |- ! Tor Browser Downloader (by {{project_name_short}} developers) | '''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. '''Less useful if run inside:''' * Disposables: because upgrades won't persist | * Disposable Template ({{whonix-ws-dvm}}) |- ! Tor Browser | '''Useful to run in:''' * {{project_name_workstation_short}} App Qube ({{project_name_workstation_vm}}) * Disposables | * {{project_name_workstation_short}} Template ({{project_name_workstation_template}}) * Disposable Template ({{whonix-ws-dvm}}) |- |} = Footnotes = {{Header}} {{Footer}}