[PATCH proxmox-datacenter-manager 1/1] faq: add warning about using apt upgrade

[PATCH proxmox-datacenter-manager 1/1] faq: add warning about using apt upgrade

[Nicolas Frey]

as it has increasingly come up in enterprise support and is generally an
easy foot gun for people coming from other Debian-based distros.

Signed-off-by: Nicolas Frey <n.frey@proxmox.com>
---

Notes:
    A similar patch that adds this warning was recently applied to PVE,
    see commit 86bddb2e3d39 in `pve-docs` for more context

 docs/faq.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/faq.rst b/docs/faq.rst
index d4ba9b50..3d8ecd3f 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -41,6 +41,12 @@ with:
   apt update
   apt full-upgrade
 
+.. warning:: As Proxmox Datacenter Manager uses a rolling release model on
+   top of Debian, performing an `apt upgrade` may result in a partially
+   upgraded or broken package state. This is because `apt full-upgrade`
+   can also remove existing packages to satisfy dependencies if needed,
+   while `apt upgrade` cannot.
+
 .. note:: Always ensure you correctly setup the :ref:`package repositories
    <sysadmin_package_repositories>` and only continue with the actual upgrade if `apt update` did
    not hit any error.
-- 
2.47.3

applied: [PATCH proxmox-datacenter-manager 1/1] faq: add warning about using apt upgrade

[Lukas Wagner]

On Thu Jul 9, 2026 at 4:26 PM CEST, Nicolas Frey wrote:
> as it has increasingly come up in enterprise support and is generally an
> easy foot gun for people coming from other Debian-based distros.
>
> Signed-off-by: Nicolas Frey <n.frey@proxmox.com>
> ---
>
> Notes:
>     A similar patch that adds this warning was recently applied to PVE,
>     see commit 86bddb2e3d39 in `pve-docs` for more context
>
>  docs/faq.rst | 6 ++++++
>  1 file changed, 6 insertions(+)
>
> diff --git a/docs/faq.rst b/docs/faq.rst
> index d4ba9b50..3d8ecd3f 100644
> --- a/docs/faq.rst
> +++ b/docs/faq.rst
> @@ -41,6 +41,12 @@ with:
>    apt update
>    apt full-upgrade
>  
> +.. warning:: As Proxmox Datacenter Manager uses a rolling release model on
> +   top of Debian, performing an `apt upgrade` may result in a partially
> +   upgraded or broken package state. This is because `apt full-upgrade`
> +   can also remove existing packages to satisfy dependencies if needed,
> +   while `apt upgrade` cannot.
> +
>  .. note:: Always ensure you correctly setup the :ref:`package repositories
>     <sysadmin_package_repositories>` and only continue with the actual upgrade if `apt update` did
>     not hit any error.

Applied, thanks!