'''Table:''' ''[[Qubes|{{q_project_name_long}}]] Release Notices''
{| class="wikitable"
|-
! scope="col"| '''Notice'''
! scope="col"| '''Description'''
|-
! scope="row"| Qubes Version Support
|
* Qubes R4.1: Supported: Whonix 16
* Qubes R4.2: Supported: Whonix 17
|-
! scope="row"| Footnotes
|
{{footnotes}}
|-
! Known Issues
|
* [https://github.com/QubesOS/qubes-issues/issues/7013 "Denied: whonix.SdwdateStatus" error message after DispVM has halted.]
|-
! scope="row"| Other Issues
|
In case technical issues are experienced such as broken dom0, broken qubes-dom0-update are Qubes issues and [[unspecific|unspecific to {{project_name_long}}]] and should therefore be either reported to [https://github.com/QubesOS/qubes-issues/issues qubes-issues], or added as a comment to an existing issue there (if appropriate). This is further elaborated in [https://forums.whonix.org/t/what-to-post-in-this-qubes-whonix-forum-and-what-not/2275 What to post in this Qubes-Whonix forum and what not.]
----
The instructions on this wiki page have bad usability. These are mostly out of control of the {{project_name_long}} project. See footnote for more information. [
* specifically: Qubes feature request: [https://github.com/QubesOS/qubes-issues/issues/6948 self-contained Qubes templates including meta scripts (salt) / improve Qubes-Whonix installation usability (#6948)]
* generally: {{kicksecure_wiki
|wikipage=Linux User Experience versus Commercial Operating Systems
|text=Linux User Experience versus Commercial Operating Systems
}}
]
|-
! scope="row"| {{q_project_name_long}} 16 to {{q_project_name_long}} 16 Release Upgrade
| This is a notice for users who currently have {{q_project_name_long}} 16 installed.
If {{q_project_name_long}} 16 is installed and you want to get {{q_project_name_long}} 17, there is no need to uninstall {{q_project_name_long}} 16 before proceeding according to the instructions on this wiki page. This is because the new templates (whonix-workstation-17, whonix-gateway-17) will be installed alongside the old templates (whonix-ws-16, whonix-gw-16).
In this case, App Qubes that were previously configured to use {{q_project_name_long}} 16 templates will keep using them -- the Templates of any App Qubes are not automatically changed to the newly installed {{q_project_name_long}} 16 templates. This is a Qubes default and [[unspecific]] to {{q_project_name_long}}. [This is also true for other distribution Templates. For example, users of the Qubes ]debian-10 Template will not have all their App Qubes updated to the new debian-11 Template by default when it is downloaded. Therefore, a manual change must be applied to App Qubes settings by the user. The rationale is to prevent unexpected changes of an App Qube's Template without the user's consent. [For example, this could result in breakage if custom-installed applications in the old Template were not available in the new Template.]
After the {{q_project_name_long}} installation has finished, it is recommended to manually change the setting of any App Qubes still using {{q_project_name_long}} 16 Templates to the {{q_project_name_long}} 16 Templates. [
* [https://github.com/QubesOS/qubes-issues/issues/5183 Qubes-Whonix ticket: Installing the new Whonix Template results in ]{{project_name_gateway_vm}} still using the old Whonix Template (#5183)]
* [https://github.com/QubesOS/qubes-issues/issues/6904 Qubes ticket: improve process for migrating from older customized Template to newer (e.g. Debian 10->11, Fedora 33->34) (#6904)]
-----
A wholly different, alternative option is to ignore all the advice on this wiki page and instead perform a [[Release Upgrade]] according to the [[Release Upgrade_16_to_17|Release Upgrade {{project_name_long}} 16 to {{project_name_long}} 17]] instructions.
|-
! scope="row"| Preexisting {{q_project_name_long}} 16 Installations
|
This is a notice for users who already have {{q_project_name_long}} 16 installed.
If any user data was stored in {{q_project_name_long}} VMs, before re-installation, back up any existing data.
-----
If you are already running [[Qubes|{{q_project_name_long}}]] 16, it must be [[Qubes/Uninstall|uninstalled]] before a complete re-installation is performed. This is also necessary when [[Qubes|{{q_project_name_long}}]] 16 is bundled as part of future Qubes releases, and auto-configuration is selected during the installation.
Choose re-installation options '''A)''' OR '''B)'''. (listed in order of preference)
* '''A)''' [[Qubes/Uninstall|Uninstall {{q_project_name_long}}]] and then [[Qubes/Install|Install {{q_project_name_long}}]]; OR
* '''B)''' [[Qubes/Reinstall|Reinstall the {{project_name_long}} Template]].
|-
|}