Skip to content

armgit / Pulse

Public Imported from GitHub
0

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.

Qualify LXC updater ownership and chart-only releases

pulse-triage[bot]af6cc9019fb4
diff --git a/docs/AUTO_UPDATE.md b/docs/AUTO_UPDATE.md
index 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:
+
```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**.
+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 Build
diff --git a/docs/RELEASE_PROCESS.md b/docs/RELEASE_PROCESS.md
index 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 unattended
systemd updater remains Stable-only. See [Automatic updates](AUTO_UPDATE.md) for
deployment-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 prepared
Releases 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.md
index 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:
+
```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**.
+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 Build
diff --git a/frontend-modern/public/docs/RELEASE_PROCESS.md b/frontend-modern/public/docs/RELEASE_PROCESS.md
index 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 unattended
systemd updater remains Stable-only. See [Automatic updates](AUTO_UPDATE.md) for
deployment-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 prepared
Releases 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.py
index 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()