{{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.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_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. * 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_short}} 16 to {{q_project_name_short}} 17 Release Upgrade | This is a notice for users who currently have {{q_project_name_short}} 16 installed. If {{q_project_name_short}} 16 is installed and you want to get {{q_project_name_short}} 17, there is no need to uninstall {{q_project_name_short}} 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_short}} 16 templates will keep using them -- the Templates of any App Qubes are not automatically changed to the newly installed {{q_project_name_short}} 16 templates. This is a Qubes default and [[unspecific]] to {{q_project_name_short}}. 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_short}} installation has finished, it is recommended to manually change the setting of any App Qubes still using {{q_project_name_short}} 16 Templates to the {{q_project_name_short}} 17 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_short}} 16 to {{project_name_short}} 17]] instructions. |- ! scope="row"| Preexisting {{q_project_name_short}} 17 Installations | This is a notice for users who already have {{q_project_name_short}} 17 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}}]] 17, it must be [[Qubes/Uninstall|uninstalled]] before a complete re-installation is performed. This is also necessary when [[Qubes|{{q_project_name_short}}]] 17 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_short}}]] and then [[Qubes/Install|Install {{q_project_name_short}}]]; OR * '''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]]