{{Header}} {{VirtualBox_CSS}}
{{Title|
title=How-to: Install {{q_project_name_long}}
}}
{{#seo:
|description=Installation Instructions, Release Notices, Disposable Template Setup, Updates over Tor
|image=Qubesinstall12312123.png
}}
{{qubes_mininav}}
[[File:Qubesinstall12312123.png|200px|thumb]]
{{intro|
Getting started with {{q_project_name_short}} in 4 steps.

Here you can find installation instructions, release notices, disposable template setup, updates over Tor and more.
}}
{{Anchor|Remove_Old_Versions}}
== {{IconSet|h1|1}} Notices ==
'''Table:''' ''[[Qubes|{{q_project_name_long}}]] Release Notices''
{| class="wikitable"
|-
! scope="col"| '''Notice'''
! scope="col"| '''Description'''
|-

! scope="row"| Qubes Version Support
|
* Qubes R4.<u>2</u>: 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 <code>dom0</code>, broken <code>qubes-dom0-update</code> are Qubes issues and [[unspecific|unspecific to {{project_name_short}}]] 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.]
|-

! scope="row"| Usability
|
The instructions on this wiki page have bad usability. These are mostly out of control of the {{project_name_short}} project. See footnote for more information. <ref>
* 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
}}
</ref>
|-

! scope="row"| {{q_project_name_short}} 16 to {{q_project_name_short}} 17 Release Upgrade
| This is a notice for users who currently have {{q_project_name_short}} <u>16</u> installed.

If {{q_project_name_short}} <u>16</u> is installed and you want to get {{q_project_name_short}} <u>17</u>, there is no need to uninstall {{q_project_name_short}} <u>16</u> before proceeding according to the instructions on this wiki page. This is because the new templates (<code>whonix-workstation-17</code>, <code>whonix-gateway-17</code>) will be installed alongside the old templates (<code>whonix-ws-16</code>, <code>whonix-gw-16</code>).

In this case, App Qubes that were previously configured to use {{q_project_name_short}} <u>16</u> templates will keep using them -- the Templates of any App Qubes are not automatically changed to the newly installed {{q_project_name_short}} <u>16</u> templates. This is a Qubes default and [[unspecific]] to {{q_project_name_short}}. <ref>This is also true for other distribution Templates. For example, users of the Qubes <code>debian-10</code> Template will not have all their App Qubes updated to the new <code>debian-11</code> Template by default when it is downloaded.</ref> 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. <ref>For example, this could result in breakage if custom-installed applications in the old Template were not available in the new Template.</ref>

After the {{q_project_name_short}} installation has finished, it is recommended to manually change the setting of any App Qubes still using {{q_project_name_short}} <u>16</u> Templates to the {{q_project_name_short}} <u>17</u> Templates. <ref>
* [https://github.com/QubesOS/qubes-issues/issues/5183 Qubes-Whonix ticket: Installing the new Whonix Template results in <code>{{project_name_gateway_vm}}</code> 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)]
</ref>
-----
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_short}} <u>16</u> to {{project_name_short}} <u>17</u>]] instructions.
|-

! scope="row"| Preexisting {{q_project_name_short}} 17 Installations
|
This is a notice for users who already have {{q_project_name_short}} <u>17</u> installed.

If any user data was stored in {{q_project_name_short}} VMs, before re-installation, back up any existing data.
-----
If you are already running [[Qubes|{{q_project_name_short}}]] <u>17</u>, it must be [[Qubes/Uninstall|uninstalled]] before a complete <u>re-installation</u> is performed. This is also necessary when [[Qubes|{{q_project_name_short}}]] <u>17</u> is bundled as part of future Qubes releases, and auto-configuration is selected during the installation.

Choose <u>re-installation</u> options '''A)''' <u>OR</u> '''B)'''. (listed in order of preference)

* '''A)''' [[Qubes/Uninstall|Uninstall {{q_project_name_short}}]] and then [[Qubes/Install|Install {{q_project_name_short}}]]; <u>OR</u>
* '''B)''' [[Qubes/Reinstall|Reinstall the {{project_name_short}} Template]].
|-

|}

== {{IconSet|h1|2}} Update dom0 ==

{{box|text=
{{Qubes_upgrade_dom0}}
}}

== {{IconSet|h1|3}} Version Number Verification ==
{{box|text=
{{Qubes_Adjust_Project_Version_Number}}
}}

== {{IconSet|h1|4}} Download and Configure {{project_name_short}} Templates ==
{{box|text=
{{Qubes_Download_Install
|enablerepo=--enablerepo=qubes-templates-community
}}

'''6.''' Next steps.

See below for additional optional configurations and additional information.
}}

== {{IconSet|h1|5}} Support the Future of {{project_name_short}} ==
{{box|text=

{{donation_appeal_download}}
}}

= Optional Steps =

== {{project_name_short}} Disposable Template ==

{{Qubes_Install_DVM}}

There is a [https://github.com/QubesOS/qubes-issues/issues/3574 Qubes bug that may cause the Disposable Template to run instead of the Disposable]. Might be fixed in Qubes R4.2. [[Unspecific|Unspecific to {{project_name_short}}]]. If this happens, just log off and back on. There is no need to reinstall or set up anything.

{{Anchor|Optional: Updates over Tor}}

== Updates over Tor ==

{{Qubes Install Updates over Tor}}

== Enable AppArmor ==
{{Qubes_AppArmor}}

= Update and Launch Applications =

{{Qubes Install Update and Launch Applications}}

= Additional Information =

== Warnings ==

{{First_Time_User}}

It is recommended to refer to these additional references:

* [[Known_Issues|Known Issues]]
* {{Post_Install_Advice}}
* [[Stay_Tuned|Follow {{project_name_short}} Developments]]

= Footnotes =
{{footnotes}}

{{reflist|close=1}}
{{Footer}}
[[Category:Documentation]]