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
Clarify unavailable Docker container updates
rcourtman197f9bac5e5e
diff --git a/docs/release-control/v6/internal/subsystems/frontend-primitives.md b/docs/release-control/v6/internal/subsystems/frontend-primitives.mdindex 1a79ba8c03..935255d69d 100644--- a/docs/release-control/v6/internal/subsystems/frontend-primitives.md+++ b/docs/release-control/v6/internal/subsystems/frontend-primitives.md@@ -2180,6 +2180,12 @@ and status payloads. Those labels are summary context inside the same strip,not a replacement status card, CTA band, or page-local nested card.1. Add shared primitives in `frontend-modern/src/components/shared/`+ Container update availability and executability are separate facts. When+ canonical action readiness refuses an update, the shared update control+ renders a passive `Update available` status with `Apply on host` guidance,+ never an Update command button. Its hover and keyboard-focus explanation+ preserves the server refusal and directs the operator to their container+ manager. In-flight actions retain their audited progress/review state.Filterable table surfaces that separate high-frequency narrowing fromdurable presentation preferences must compose`frontend-modern/src/components/shared/FilterBar/ViewOptionsDisclosure.tsx`.diff --git a/frontend-modern/browser-verification/a524ad0120d24f8d.json b/frontend-modern/browser-verification/a524ad0120d24f8d.jsonnew file mode 100644index 0000000000..7d5f53a18b--- /dev/null+++ b/frontend-modern/browser-verification/a524ad0120d24f8d.json@@ -0,0 +1,39 @@+{+ "version": 1,+ "base_sha": "8c9c628c28a40d2295cb193cfb6504991bc9b871",+ "verified_at": "2026-10-08T10:21:05.285Z",+ "result": "passed",+ "changed_paths": [+ "frontend-modern/src/components/shared/ContainerUpdateBadge.tsx",+ "frontend-modern/src/components/shared/useContainerUpdateButtonState.ts"+ ],+ "content_sha256": {+ "frontend-modern/src/components/shared/ContainerUpdateBadge.tsx": "e8fa83fb1d65ab587f6e85b5011469fe25512a8ca6d040e6f4dba9d82a5f44ab",+ "frontend-modern/src/components/shared/useContainerUpdateButtonState.ts": "5c56b2e2eb47084ad0ce62de1814268fa6b9fe129b17f646ba4584cbb7ab7834"+ },+ "routes": [+ "/docker/overview"+ ],+ "viewports": [+ {+ "width": 1440,+ "height": 1000+ },+ {+ "width": 900,+ "height": 900+ },+ {+ "width": 390,+ "height": 844+ }+ ],+ "states": [+ "Four unavailable updates; current byparr and sonarr; PBS failed check",+ "Refusal removed on reload restores enabled Update for one host"+ ],+ "interactions": [+ "Hover, keyboard focus, Escape, status click without planning or row expansion, Tab blur at all three widths",+ "Reload with changed canonical readiness; enabled Update opens review and Escape closes without approval or execution"+ ]+}diff --git a/frontend-modern/src/components/shared/ContainerUpdateBadge.tsx b/frontend-modern/src/components/shared/ContainerUpdateBadge.tsxindex ed514331ed..8e5019054c 100644--- a/frontend-modern/src/components/shared/ContainerUpdateBadge.tsx+++ b/frontend-modern/src/components/shared/ContainerUpdateBadge.tsx@@ -215,11 +215,21 @@ export const UpdateIcon: Component<UpdateIconProps> = (props) => {*/export const UpdateButton: Component<UpdateButtonProps> = (props) => {const state = useContainerUpdateButtonState(props);+ const readOnlyUpdateExplanation = () =>+ `Update available. Pulse cannot apply it: ${state.updateUnavailableReason()}\nApply this update using your container manager on the host.`;+ const showReadOnlyUpdateExplanation = (target: HTMLElement) => {+ const rect = target.getBoundingClientRect();+ showTooltip(readOnlyUpdateExplanation(), rect.left + rect.width / 2, rect.top, {+ align: 'center',+ direction: 'up',+ });+ };const shouldRenderReadOnlyStatus = () =>state.currentState() === 'idle' &&(hasContainerUpdateError(props.updateStatus) ||hasContainerUpdateCurrent(props.updateStatus) ||isContainerUpdatePinned(props.updateStatus) ||+ state.isUpdateUnavailable() ||(state.settingsLoaded() && state.shouldHideButton()));return (@@ -287,11 +297,40 @@ export const UpdateButton: Component<UpdateButtonProps> = (props) => {</div>}>- <ContainerUpdateBadge- updateStatus={props.updateStatus}- compact={props.compact}- showCurrent={true}- />+ <Show+ when={hasContainerUpdate(props.updateStatus) && state.isUpdateUnavailable()}+ fallback={+ <ContainerUpdateBadge+ updateStatus={props.updateStatus}+ compact={props.compact}+ showCurrent={true}+ />+ }+ >+ <span+ class="inline-flex flex-col items-center gap-0.5 text-[11px] text-muted cursor-help focus-visible:outline focus-visible:outline-2 focus-visible:outline-primary"+ tabindex="0"+ aria-label={readOnlyUpdateExplanation()}+ data-prevent-toggle+ onClick={(event) => {+ event.stopPropagation();+ showReadOnlyUpdateExplanation(event.currentTarget);+ }}+ onMouseEnter={(event) => showReadOnlyUpdateExplanation(event.currentTarget)}+ onMouseLeave={() => hideTooltip()}+ onFocus={(event) => showReadOnlyUpdateExplanation(event.currentTarget)}+ onBlur={() => hideTooltip()}+ onKeyDown={(event) => {+ if (event.key === 'Escape') hideTooltip();+ }}+ >+ <span class="inline-flex items-center gap-1 whitespace-nowrap rounded-full bg-surface-alt px-1.5 py-0.5 font-medium">+ <ErrorIndicatorIcon class="h-3 w-3" />+ <span>Update available</span>+ </span>+ <span>Apply on host</span>+ </span>+ </Show></Show></Show>);diff --git a/frontend-modern/src/components/shared/__tests__/ContainerUpdateBadge.test.tsx b/frontend-modern/src/components/shared/__tests__/ContainerUpdateBadge.test.tsxindex 835787083b..0761a16a20 100644--- a/frontend-modern/src/components/shared/__tests__/ContainerUpdateBadge.test.tsx+++ b/frontend-modern/src/components/shared/__tests__/ContainerUpdateBadge.test.tsx@@ -137,7 +137,7 @@ describe('ContainerUpdateBadge', () => {expect(screen.getByRole('button', { name: /update/i })).toBeInTheDocument();});- it('disables the button with the refusal reason when the server refuses the update capability', () => {+ it('shows update availability and host guidance without an action when the server refuses updates', () => {render(() => (<UpdateButtonagentId="agent-1"@@ -161,11 +161,15 @@ describe('ContainerUpdateBadge', () => {/>));- const button = screen.getByRole('button', { name: /update unavailable/i });- expect(button).toBeDisabled();- expect(button.getAttribute('aria-label')).toContain(+ expect(screen.queryByRole('button')).not.toBeInTheDocument();+ expect(screen.getByText('Update available')).toBeInTheDocument();+ expect(screen.getByText('Apply on host')).toBeInTheDocument();+ const status = screen.getByLabelText(/Pulse cannot apply it/);+ expect(status.getAttribute('aria-label')).toContain('The Pulse agent on this host is still on an older version.',);+ fireEvent.click(status);+ expect(ResourceActionsAPI.planAction).not.toHaveBeenCalled();});it('keeps the button enabled when the update readiness entry is available', () => {diff --git a/frontend-modern/src/components/shared/useContainerUpdateButtonState.ts b/frontend-modern/src/components/shared/useContainerUpdateButtonState.tsindex facab5ad26..714ada7b91 100644--- a/frontend-modern/src/components/shared/useContainerUpdateButtonState.ts+++ b/frontend-modern/src/components/shared/useContainerUpdateButtonState.ts@@ -74,8 +74,8 @@ export function useContainerUpdateButtonState(props: UpdateButtonProps) {currentState() !== 'idle';// Server-evaluated refusal for the update capability (agent disconnected,- // agent too old, stale inventory). Mirrors the lifecycle buttons: render- // disabled with the reason instead of letting the click fail at plan time.+ // agent too old, stale inventory). Render a passive update status with the+ // reason instead of suggesting that Pulse can apply the update.// Only gates the actionable states; in-flight and settled states keep their// own presentation.const updateUnavailableReason = (): string | undefined => {@@ -209,5 +209,6 @@ export function useContainerUpdateButtonState(props: UpdateButtonProps) {reviewDetail,settingsLoaded,shouldHideButton,+ updateUnavailableReason,};}