<!--
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> &rarr; <code>{{project_name_workstation_short}} App Qube (commonly called {{Code2|{{project_name_workstation_vm}}}})</code> &rarr; <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>