* [PATCH pmg-docs 1/1] faq: add warning about using apt upgrade
@ 2026-07-09 14:26 Nicolas Frey
0 siblings, 0 replies; only message in thread
From: Nicolas Frey @ 2026-07-09 14:26 UTC (permalink / raw)
To: pmg-devel
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
^ permalink raw reply related [flat|nested] only message in thread
only message in thread, other threads:[~2026-07-09 14:26 UTC | newest]
Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-07-09 14:26 [PATCH pmg-docs 1/1] faq: add warning about using apt upgrade Nicolas Frey
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.