Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.
Go aialertsdashboarddockerdocker-monitoringgohomelabinfrastructure-monitoringkubernetesmonitoringmspproxmoxproxmox-backup-serverproxmox-mail-gatewayproxmox-veself-hostedtruenastypescriptvspherewebhooks
Qualify LXC updater ownership and chart-only releases
pulse-triage[bot]af6cc9019fb4
diff --git a/docs/AUTO_UPDATE.md b/docs/AUTO_UPDATE.mdindex 38dbff640e..436b7574f3 100644--- a/docs/AUTO_UPDATE.md+++ b/docs/AUTO_UPDATE.md@@ -101,19 +101,39 @@ container updates are separate operations.### ProxmoxVE LXC (Manual)+Check which updater owns the installation before running a command. A container+created with Proxmox community-scripts can have its own `/bin/update`; the path+alone does not identify the Pulse-owned helper, and that updater can ignore+`--version`.++Run the following only if `/bin/update` was installed by the Pulse server+installer:+```bashsudo /bin/update```-`/bin/update` is installed by the supported Pulse server installer and preserves the signed-installer trust chain. If your host does not have it yet, use the signed server-installer flow in [INSTALL.md](INSTALL.md). Agent updates still use the `/install.sh` command generated in **Settings → Infrastructure → Install on a host**.+If the helper is absent or its owner is unknown, use the+[signed server-installer flow](INSTALL.md#2-bare-metal--systemd) with+`PULSE_VERSION` set to the exact software tag. Follow the+[backup and update precautions](INSTALL.md#manual-update) first. Agent updates+still use the `/install.sh` command generated in **Settings → Infrastructure →+Install on a host**.++If a helper selects `helm-chart-*`, stop: that is a Helm chart release, not a+Pulse server archive. Use a published software tag such as `vX.Y.Z`, not the+first entry in the releases list; see+[software releases and Helm charts](RELEASE_PROCESS.md#software-releases-and-helm-charts).+For a running LXC, **Settings → System → Updates** uses Pulse's own release+selector when an in-app update is offered. After a failed attempt, check the+running version and service health before choosing another update route; do not+repeat the failed helper or reinstall just to reproduce it.### Systemd Service (Manual)-```bash-sudo /bin/update-```--`/bin/update` is installed by the supported Pulse server installer and preserves the signed-installer trust chain. If your host does not have it yet, use the signed server-installer flow in [INSTALL.md](INSTALL.md). Agent updates still use the `/install.sh` command generated in **Settings → Infrastructure → Install on a host**.+Use the same [helper ownership check and signed update route](#proxmoxve-lxc-manual)+as an LXC installation. A helper at `/bin/update` is not proof of its provenance+on a custom systemd install either.### Source Builddiff --git a/docs/RELEASE_PROCESS.md b/docs/RELEASE_PROCESS.mdindex 6a3e8d80ca..92151f35ba 100644--- a/docs/RELEASE_PROCESS.md+++ b/docs/RELEASE_PROCESS.md@@ -31,6 +31,21 @@ Choosing Preview does not make a beta production-qualified. Pulse's unattendedsystemd updater remains Stable-only. See [Automatic updates](AUTO_UPDATE.md) fordeployment-specific update behaviour.+## Software releases and Helm charts++The releases list contains both Pulse software and Helm charts. Software tags+use `vX.Y.Z` for stable releases, with a prerelease suffix for previews. Tags+starting with `helm-chart-` contain chart packaging for Kubernetes; they are not+Pulse server archives and cannot update a systemd or Proxmox LXC server.++List order does not establish the latest software release: a chart can be+published after its corresponding server release. Choose the published software+tag and its server assets for a server update, or use Pulse's **Settings → System+→ Updates** selector. If a third-party helper chooses a chart tag, do not work+around the failure by disabling signature verification or replacing the server+with a chart asset. Follow the existing installation's+[signed update route and helper ownership checks](AUTO_UPDATE.md#proxmoxve-lxc-manual).+## How releases are preparedReleases follow a fixed schedule rather than individual judgment.diff --git a/frontend-modern/public/docs/AUTO_UPDATE.md b/frontend-modern/public/docs/AUTO_UPDATE.mdindex 38dbff640e..436b7574f3 100644--- a/frontend-modern/public/docs/AUTO_UPDATE.md+++ b/frontend-modern/public/docs/AUTO_UPDATE.md@@ -101,19 +101,39 @@ container updates are separate operations.### ProxmoxVE LXC (Manual)+Check which updater owns the installation before running a command. A container+created with Proxmox community-scripts can have its own `/bin/update`; the path+alone does not identify the Pulse-owned helper, and that updater can ignore+`--version`.++Run the following only if `/bin/update` was installed by the Pulse server+installer:+```bashsudo /bin/update```-`/bin/update` is installed by the supported Pulse server installer and preserves the signed-installer trust chain. If your host does not have it yet, use the signed server-installer flow in [INSTALL.md](INSTALL.md). Agent updates still use the `/install.sh` command generated in **Settings → Infrastructure → Install on a host**.+If the helper is absent or its owner is unknown, use the+[signed server-installer flow](INSTALL.md#2-bare-metal--systemd) with+`PULSE_VERSION` set to the exact software tag. Follow the+[backup and update precautions](INSTALL.md#manual-update) first. Agent updates+still use the `/install.sh` command generated in **Settings → Infrastructure →+Install on a host**.++If a helper selects `helm-chart-*`, stop: that is a Helm chart release, not a+Pulse server archive. Use a published software tag such as `vX.Y.Z`, not the+first entry in the releases list; see+[software releases and Helm charts](RELEASE_PROCESS.md#software-releases-and-helm-charts).+For a running LXC, **Settings → System → Updates** uses Pulse's own release+selector when an in-app update is offered. After a failed attempt, check the+running version and service health before choosing another update route; do not+repeat the failed helper or reinstall just to reproduce it.### Systemd Service (Manual)-```bash-sudo /bin/update-```--`/bin/update` is installed by the supported Pulse server installer and preserves the signed-installer trust chain. If your host does not have it yet, use the signed server-installer flow in [INSTALL.md](INSTALL.md). Agent updates still use the `/install.sh` command generated in **Settings → Infrastructure → Install on a host**.+Use the same [helper ownership check and signed update route](#proxmoxve-lxc-manual)+as an LXC installation. A helper at `/bin/update` is not proof of its provenance+on a custom systemd install either.### Source Builddiff --git a/frontend-modern/public/docs/RELEASE_PROCESS.md b/frontend-modern/public/docs/RELEASE_PROCESS.mdindex 6a3e8d80ca..92151f35ba 100644--- a/frontend-modern/public/docs/RELEASE_PROCESS.md+++ b/frontend-modern/public/docs/RELEASE_PROCESS.md@@ -31,6 +31,21 @@ Choosing Preview does not make a beta production-qualified. Pulse's unattendedsystemd updater remains Stable-only. See [Automatic updates](AUTO_UPDATE.md) fordeployment-specific update behaviour.+## Software releases and Helm charts++The releases list contains both Pulse software and Helm charts. Software tags+use `vX.Y.Z` for stable releases, with a prerelease suffix for previews. Tags+starting with `helm-chart-` contain chart packaging for Kubernetes; they are not+Pulse server archives and cannot update a systemd or Proxmox LXC server.++List order does not establish the latest software release: a chart can be+published after its corresponding server release. Choose the published software+tag and its server assets for a server update, or use Pulse's **Settings → System+→ Updates** selector. If a third-party helper chooses a chart tag, do not work+around the failure by disabling signature verification or replacing the server+with a chart asset. Follow the existing installation's+[signed update route and helper ownership checks](AUTO_UPDATE.md#proxmoxve-lxc-manual).+## How releases are preparedReleases follow a fixed schedule rather than individual judgment.diff --git a/scripts/release_control/release_promotion_policy_test.py b/scripts/release_control/release_promotion_policy_test.pyindex 2afec0233c..ee54dc4662 100644--- a/scripts/release_control/release_promotion_policy_test.py+++ b/scripts/release_control/release_promotion_policy_test.py@@ -1699,6 +1699,44 @@ class ReleasePromotionPolicyTest(unittest.TestCase):self.assertIn("This also applies to rollback", server_updates)self.assertIn("Verify the installed version with `GET /api/version`", server_updates)+ def test_manual_update_help_preserves_helper_ownership_and_software_identity(self) -> None:+ automatic_updates = read("docs/AUTO_UPDATE.md")+ lxc_updates = normalize_ws(+ automatic_updates.split("### ProxmoxVE LXC (Manual)", 1)[1].split("\n### ", 1)[0]+ )+ systemd_updates = normalize_ws(+ automatic_updates.split("### Systemd Service (Manual)", 1)[1].split("\n### ", 1)[0]+ )+ release_guide = normalize_ws(+ read("docs/RELEASE_PROCESS.md").split("## Software releases and Helm charts", 1)[1]+ .split("\n## ", 1)[0]+ )++ # The copied command must have its ownership condition before it, not+ # an unconditional command followed by an assumed installer origin.+ command_position = lxc_updates.index("sudo /bin/update")+ self.assertIn(+ "only if `/bin/update` was installed by the Pulse server installer",+ lxc_updates[:command_position],+ )+ self.assertIn("that updater can ignore `--version`", lxc_updates)+ self.assertIn("the helper is absent or its owner is unknown", lxc_updates)+ self.assertIn("[signed server-installer flow](INSTALL.md#2-bare-metal--systemd)", lxc_updates)+ self.assertIn("`PULSE_VERSION` set to the exact software tag", lxc_updates)+ self.assertIn("[backup and update precautions](INSTALL.md#manual-update)", lxc_updates)+ self.assertIn("check the running version and service health", lxc_updates)+ self.assertIn("do not repeat the failed helper or reinstall just to reproduce it", lxc_updates)+ self.assertIn("[helper ownership check and signed update route](#proxmoxve-lxc-manual)", systemd_updates)+ self.assertNotIn("sudo /bin/update", systemd_updates)++ self.assertIn("`helm-chart-*`", lxc_updates)+ self.assertIn("not a Pulse server archive", lxc_updates)+ self.assertIn("not the first entry in the releases list", lxc_updates)+ self.assertIn("List order does not establish the latest software release", release_guide)+ self.assertIn("cannot update a systemd or Proxmox LXC server", release_guide)+ self.assertIn("disabling signature verification", release_guide)+ self.assertIn("Settings → System → Updates", lxc_updates)+def test_upgrade_guide_points_at_current_rc_support_pack(self) -> None:upgrade_guide = read("docs/UPGRADE_v6.md")current_version = read("VERSION").strip()