{{project_name_gateway_vm}} and {{project_name_workstation_vm}}.
{{IconSet|h2|1}} '''Download speed notice.'''
This downloading procedure can take a long time to finish. Fast Internet connections take only a few minutes, while slow connections can take twenty minutes or more (it is far slower over Tor).
{{IconSet|h2|2}} '''Download both [[{{project_name_gateway_short}}|{{project_name_gateway_long}}]] and [[{{project_name_workstation_short}}|{{project_name_workstation_long}}]] Templates.'''
In dom0.
The following qvm-template command is:
* Optional.
* Useful because it has a progress indicator, while the subsequent qubesctl command does not. (Qubes feature request: [https://github.com/QubesOS/qubes-issues/issues/4215 add salt download progress indicator]) It is very confusing to have a long-running download command with no progress bar, especially over Tor.
* Insufficient by itself - the subsequent qubesctl command that follows is mandatory, as per [https://github.com/QubesOS/qubes-issues/issues/3447 phase out manual use of qubes-dom0-update by user / replace it by salt] and [[Dev/Qubes#salt]].
* --enablerepo=qubes-templates-community:
** --enablerepo=qubes-templates-community can be omitted if the Qubes Community Templates Repository is already enabled in dom0.
** The Qubes Community Templates Repository should already be enabled by default, unless disabled by the user, restored {{q_project_name_long}} from backup, or in some other edge case.
** Recommending typing --enablerepo=qubes-templates-community is poor usability, since users cannot copy from their VM browser (where they are most likely reading this) to dom0. But too many people reported this issue. [https://forums.whonix.org/t/had-to-enable-community-templates-to-get-new-template/12489 had to enable Qubes templates community repository]
** If the Qubes Community Templates Repository is not enabled in dom0, explicitly add --enablerepo=qubes-templates-community or enable it through editing the /etc/yum.repos.d/qubes-templates.repo file in dom0.
{{Box|text=
In dom0.
{{IconSet|h2|1}} '''Open file /etc/yum.repos.d/qubes-templates.repo in a text editor with root rights.'''
{{CodeSelect|code=
sudo nano /etc/yum.repos.d/qubes-templates.repo
}}
{{IconSet|h2|2}} '''In section [qubes-templates-community], add the following.'''
{{CodeSelect|code=
enabled = 1
}}
{{IconSet|h2|3}} '''Save.'''
{{IconSet|h2|4}} '''Done.'''
Qubes Community Templates Repository has been enabled. The command line parameter --enablerepo=qubes-templates-community should no longer be required.
{{IconSet|h2|5}} '''Report.'''
Please report if this step was necessary for you!
}}
To download {{project_name_gateway_short}} and {{project_name_workstation_short}}, select your version of Qubes OS and.
{{Tab
|type=controller
|content=
{{Tab
|title= == Qubes R4.2 ==
|content=
Run this command:
{{CodeSelect|code=
qvm-template install --enablerepo=qubes-templates-community whonix-gateway-17 whonix-workstation-17
}}
}}
{{Tab
|title= == Qubes R4.3 ==
|content=
Run this command:
Note: [https://github.com/QubesOS/updates-status/issues/6276 The "-testing" in the following command can soon be removed.]
{{CodeSelect|code=
qvm-template install --enablerepo=qubes-templates-community-testing whonix-gateway-18 whonix-workstation-18
}}
}}
}}
{{IconSet|h2|3}} '''Configure {{project_name_gateway_vm}} and {{project_name_workstation_vm}} safely.'''
* Do not interrupt the salt process once it has started, or this can lead to an [https://groups.google.com/g/qubes-users/c/fwCqxENXguY unstable system].
* qubesctl: This is a Qubes command, not from {{project_name_short}}. Advanced users may refer to [https://www.qubes-os.org/doc/salt/ Qubes salt management stack qubesctl] for further information about qubesctl and Qubes salt.
* If Templates were not previously downloaded using the above qvm-template command, then the qubesctl command would also download both {{project_name_gateway_short}} and {{project_name_workstation_short}} Templates.
* Related source code files, for developer reference only:
** https://github.com/QubesOS/qubes-mgmt-salt-dom0-virtual-machines/blob/master/qvm/{{project_name_gateway_vm}}.sls
** https://github.com/QubesOS/qubes-mgmt-salt-dom0-virtual-machines/blob/master/qvm/{{project_name_workstation_vm}}.sls
In dom0, run.
No progress indicator is shown. Qubes feature request: [https://github.com/QubesOS/qubes-issues/issues/4215 add salt download progress indicator]
{{CodeSelect|code=
sudo qubesctl state.sls qvm.{{project_name_workstation_vm}}
}}
{{IconSet|h2|4}} '''In case of issues.'''
Only in case of issues, refer to the footnotes for troubleshooting tips.
If qubesctl still does not work, try shutting down Qubes OS and rebooting the machine.
Please report if this step was necessary for you!
Otherwise, proceed.
{{IconSet|h2|5}} '''Done.'''
Download and installation of {{q_project_name_short}} has been completed.