<!-- WIKI EDITORS NOTE; https://github.com/{{project_name_short}}/tb-starter/blob/master/usr/bin/torbrowser links here. Therefore writing Tor Browser Downloader by {{project_name_short}} in full and hyperlinking it. --> {{mbox | image = [[File:Ambox_warning_pn.svg.png|40px]] | text = Do <u>not</u> run Tor Browser in a Template (<code>{{project_name_workstation_template}}</code>) or Disposable Template (<code>{{whonix-ws-dvm}}</code>)! }} Unfortunately, updating Tor Browser is more complex than regular system updates due to technical limitations outside of Whonix's control. <ref>[[Tor_Browser/Advanced_Users#Tor_Browser_Update:_Technical_Details|Tor Browser Update: Technical Details]]</ref> 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}} (<code>update-torbrowser</code>) automatically runs when the {{project_name_workstation_long}} Template (<code>{{project_name_workstation_template}}</code>) package <code>tb-updater</code> is updated. Therefore, running Tor Browser Downloader by {{project_name_short}} inside the Template (<code>{{project_name_workstation_template}}</code>) ensures that <u>new</u> 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 <code>tb-updater</code> has not been updated yet, it is advised to manually run it in the {{project_name_workstation_short}} Template (<code>{{project_name_workstation_template}}</code>). 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 <u>not</u> run Tor Browser Downloader by {{project_name_short}} inside the Disposable Template (<code>{{whonix-ws-dvm}}</code>)! It should only be run in the Template (<code>{{project_name_workstation_template}}</code>) or in a <code>{{project_name_workstation_template}}</code>-based App Qube (<code>{{project_name_workstation_vm}}</code>). <ref>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.</ref> <ref>See [[Tor_Browser/Advanced_Users#tb-updater_in_Qubes_Template|tb-updater in Qubes Template]] for technical details.</ref> }} 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 <u>existing</u> {{project_name_workstation_short}} App Qube such as <code>{{project_name_workstation_vm}}</code>: # Start Tor Browser: <code>Qubes Start Menu</code> → <code>{{project_name_workstation_short}} App Qube (commonly called {{Code2|{{project_name_workstation_vm}}}})</code> → <code>Tor Browser</code> # Use [[Tor_Browser#Tor Browser Internal Updater|Tor Browser Internal Updater]]. ==== Summary ==== <u>Tor Browser Downloader (by {{project_name_short}} developers)</u>: {{Code2|Tor Browser Downloader (by {{project_name_short}} developers)}} is useful to run inside: * <code>{{project_name_workstation_short}} Template</code> (<code>{{project_name_workstation_template}}</code>): to ensure that <u>new</u> App Qubes and [[Qubes/Disposables|Disposables]] are created with a copy of the latest Tor Browser version. * <code>{{project_name_workstation_short}} App Qube</code> (<code>{{project_name_workstation_vm}}</code>): to re-install the latest Tor Browser version in <u>existing</u> {{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 <u>not</u> be run in: * Disposable Template (<code>{{whonix-ws-dvm}}</code>) <u>Tor Browser</u>: {{Code2|Tor Browser}} is useful to run in: * <code>{{project_name_workstation_short}} App Qube</code> (<code>{{project_name_workstation_vm}}</code>) * Dispoables {{Code2|Tor Browser}} should <u>not</u> be run in: * <code>{{project_name_workstation_short}} Template</code> (<code>{{project_name_workstation_template}}</code>) * Disposable Template (<code>{{whonix-ws-dvm}}</code>)<noinclude> {{Header}} {{Footer}} </noinclude>