{{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]]