{{Header}} {{Title|title= Update {{q_project_name_long}} }} {{#seo: |description=How to update {{q_project_name_short}}. |image=Qubesupdate12312345.png }} [[File:Qubesupdate12312345.png|250px|thumb]] {{intro| How to update {{q_project_name_short}}. }} = End-of-life Software = {{End_of_life_software}} = Installing Additional Software = See [[Install Software]]. = Updates = == Standard Update vs Release Upgrade == This procedure is for normal ("everyday") updates of [[Qubes|{{q_project_name_short}}]] and will not perform a [[Release Upgrade]]. Before applying a release upgrade, it is recommended to first complete a standard update in both the <code>{{project_name_gateway_template}}</code> and <code>{{project_name_workstation_template}}</code> Templates, via <code>xfce4-terminal</code>: * <code>Qubes App Menu(blue/grey "Q")</code> → <code>Template: {{project_name_gateway_template}}</code> → <code>xfce4-terminal</code> * <code>Qubes App Menu(blue/grey "Q")</code> → <code>Template: {{project_name_workstation_template}}</code> → <code>xfce4-terminal</code> Afterward, perform the [[#Standard_Update_Steps|Standard Update Steps]] below in both terminals. == Warnings == {{mbox | type = notice | image = [[File:Ambox_notice.png|40px|alt=Info]] | text = <br /> * At least once a day, Qubes users should update the system package lists in all Templates, Standalones <u>and</u> <code>dom0</code> with the latest version information on new and updated packages that are available for download. <ref>See: [https://www.qubes-os.org/doc/how-to-update/ How to update].</ref> * Below are some warnings and issues which are general Qubes bugs and [[Unspecific|unspecific to {{q_project_name_short}}]]. Primary sources from Qubes OS are referenced as links with specific citations. }} {{mbox | image = [[File:Ambox_warning_pn.svg.png|40px]] | text = Quote [https://www.qubes-os.org/doc/how-to-update/#command-line-interface Qubes OS "How to update" warning]: <blockquote>Warning: Updating ''exclusively'' with direct commands such as <code>qubes-dom0-update</code>, <code>dnf update</code>, and <code>apt update</code> is not recommended, since these bypass built-in Qubes OS update security measures. Instead, we strongly recommend first using the '''Qubes Update''' tool or its command-line equivalents, as described below, then using the direct commands for confirmation (see [https://github.com/QubesOS/qubes-issues/issues/6585 #6585] and [https://github.com/QubesOS/qubes-posts/pull/79 PR #79]). (By contrast, [https://www.qubes-os.org/doc/how-to-install-software/ installing] packages using direct package manager commands is fine.)</blockquote> * [https://www.qubes-os.org/doc/how-to-update/#routine-updates '''Qubes Update''' tool] * For updating using command-line, refer to [https://www.qubes-os.org/doc/how-to-update/#command-line-interface Qubes OS "How to update"]: ** [https://www.qubes-os.org/doc/salt/#updatequbes-vm update using Qubes salt, <code>update.qubes-vm</code>] ** [https://www.qubes-os.org/doc/salt/#updatequbes-dom0 update using Qubes salt, <code>update.qubes-dom0</code>] The situation is however [https://github.com/QubesOS/qubes-posts/pull/79#issuecomment-1042934326 complicated] due to [https://github.com/QubesOS/qubes-issues/labels/C:%20updates Qubes Updater Issues], most notably such as: * [https://github.com/QubesOS/qubes-issues/issues/7254 qubes-dom0-update shows <code>No updates available</code> in case of network is down / <code>qubes-dom0-update</code> fails to notice if repositories are unreachable / network is down], * [https://github.com/QubesOS/qubes-issues/issues/6635 Replace built-in Qube Manager update functionality with the Qubes Update tool]. }} == Standard Update Steps == {{mbox | type = notice | image = [[File:Ambox_notice.png|40px|alt=Info]] | text = Note: Updating Tor Browser is a separate issue; see [[Qubes/Tor_Browser|Update Tor Browser]]. }} {{Box|text= {{Qubes_Operating_System_Updates}} }} = Non-functional Onion Services = {{Non-functional Onion Services}} = Updating with Extra Care = See {{kicksecure_wiki |wikipage=Install_Software#How-to:_Install_or_Update_with_Utmost_Caution |text=How-to: Install or Update with Utmost Caution }}. = Footnotes = {{reflist|close=1}} {{Footer}} [[Category:Documentation]]