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

[PATCH proxmox-backup 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 4ae4573c5..e9ba32609 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -48,6 +48,12 @@ through the CLI with:
   apt update
   apt full-upgrade
 
+.. warning:: As Proxmox Backup Server 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

Re: [PATCH proxmox-backup 1/1] faq: add warning about using apt upgrade

[Christian Ebner]

On 7/9/26 4:26 PM, 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 4ae4573c5..e9ba32609 100644
> --- a/docs/faq.rst
> +++ b/docs/faq.rst
> @@ -48,6 +48,12 @@ through the CLI with:
>     apt update
>     apt full-upgrade
>   
> +.. warning:: As Proxmox Backup Server 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.

Pondered shortly if it would make sense to combine the warning and note, 
but since the contained information is tangentially related only and if 
one reads the warning most likely also the note below let's leave them 
separate.

Acked-by: Christian Ebner <c.ebner@proxmox.com>