[PATCH pmg-docs 1/1] faq: add warning about using apt upgrade

[PATCH pmg-docs 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

 pmg-faq.adoc | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/pmg-faq.adoc b/pmg-faq.adoc
index 602a9d1..a8a1e73 100644
--- a/pmg-faq.adoc
+++ b/pmg-faq.adoc
@@ -68,6 +68,11 @@ apt update
 apt full-upgrade
 ----
 +
+WARNING: As {pmg} 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 that you correctly set up the
 xref:pmg_package_repositories[package repositories], and only continue with the
 actual upgrade if `apt update` did not hit any errors.
-- 
2.47.3

applied: [PATCH pmg-docs 1/1] faq: add warning about using apt upgrade

[Stoiko Ivanov]

Thanks for providing the patch for PMG as well!

On Thu, 09 Jul 2026 16:26:06 +0200, 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.
> 
> 

Applied, thanks!

[1/1] faq: add warning about using apt upgrade
      commit: 8d1f840ac89fb9991160f3efc2fb98ee3baa915e