{{Header}} {{Title|title= Update {{q_project_name_long}} }} {{#seo: |description=How to update {{q_project_name_short}}. |image=Qubesupdate12312345.png }} [[image: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 {{project_name_gateway_template}} and {{project_name_workstation_template}} Templates, via xfce4-terminal: * Qubes App Menu(blue/grey "Q")Template: {{project_name_gateway_template}}xfce4-terminal * Qubes App Menu(blue/grey "Q")Template: {{project_name_workstation_template}}xfce4-terminal 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 =
* At least once a day, Qubes users should update the system package lists in all Templates, Standalones and dom0 with the latest version information on new and updated packages that are available for download. See: [https://www.qubes-os.org/doc/how-to-update/ How to update]. * 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]:
Warning: Updating ''exclusively'' with direct commands such as qubes-dom0-update, dnf update, and apt update 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.)
* [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, update.qubes-vm] ** [https://www.qubes-os.org/doc/salt/#updatequbes-dom0 update using Qubes salt, update.qubes-dom0] 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 No updates available in case of network is down / qubes-dom0-update 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]]