{{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> &rarr; <code>Template: {{project_name_gateway_template}}</code> &rarr; <code>xfce4-terminal</code>
* <code>Qubes App Menu(blue/grey "Q")</code> &rarr; <code>Template: {{project_name_workstation_template}}</code> &rarr; <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]]