==== Quick Rules ==== {{mbox | image = [[File:Ambox_notice.png|40px]] | text = Updating Tor Browser can be 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]] Use the table below and follow the instructions for your situation. }} {| class="wikitable" |+ ''Where to run what yes (recommended) versus no (not recommended)'' ! Tool ! Template
({{project_name_workstation_template}}) ! App Qube
({{project_name_workstation_vm}}) ! Disposable VM
(disp####) ! Disposable Template
({{whonix-ws-dvm}}) |- ! Tor Browser | {{no}} | {{yes}} | {{yes}} | {{no}} |- ! Tor Browser Downloader by {{project_name_short}}
(update-torbrowser) | {{yes}} | {{yes}} Useful for re-installing Tor Browser in that App Qube. | {{no}} Updates inside a Disposable VM do not persist after shutdown. | {{no}} |- |} {{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}})! }} {{mbox | image = [[File:Ambox_notice.png|40px]] | text = '''Quick rules:''' * Run '''Tor Browser''' only in App Qubes or Disposables. * Run '''Tor Browser Downloader by {{project_name_short}}''' (update-torbrowser) only in the Template and/or in an App Qube. * Never run Tor Browser or the downloader inside the '''Disposable Template''' ({{whonix-ws-dvm}}). }} ==== Overview ==== ''Tip:'' If you are unsure, start with the '''Existing App Qubes''' row. {| class="wikitable" |+ ''Qubes VM Scenario and Instructions'' ! Scenario ! Instructions ! Common confusion about terms |- ! {{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) normally runs automatically when the {{project_name_workstation_long}} Template ({{project_name_workstation_template}}) package tb-updater is updated. 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 you want the newest Tor Browser sooner, you can 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}}]]. | In Qubes terms, this row is about updating the Template ({{project_name_workstation_template}}) so that new App Qubes and Disposables start with the updated Tor Browser. "Disposables" here means the spawned Disposable VM instances (often named disp####). This is not about the Disposable Template ({{whonix-ws-dvm}}). |- ! {{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}}]]. | "Disposable Template" ({{whonix-ws-dvm}}) is the base VM used to create Disposables. By Qubes convention, a Disposable Template VM name often ends with -dvm. The "Disposable Template" is not the same as an actual Disposable VM instance. The warning is about not running Tor Browser or the downloader inside the Disposable Template itself. Tor Browser is meant to run in a spawned Disposable VM (often named disp####, for example disp1234) or in an App Qube. |- ! {{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 (recommended): Use [[Tor_Browser#Tor Browser Internal Updater|Tor Browser Internal Updater]]. * '''C)''' Re-install Tor Browser (only if needed): Use [[Tor_Browser#Tor_Browser_Downloader_by_Whonix|Tor Browser Downloader by {{project_name_short}} developers]]. | "Update" (internal updater) and "re-install" (downloader) are different actions. Updating Tor Browser inside one existing App Qube affects only that App Qube. This does not automatically update other App Qubes, and this does not update the Template used for new App Qubes and Disposables. |- |} ==== Summary ==== {| class="wikitable" |+ ''Comparison of Applications, Recommended and Discouraged Use'' ! 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. '''Usually not useful if run inside:''' * Disposables: because upgrades will not 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}}