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.

Mention Pulse MSP in Plans & Billing

[email protected]0f9cd07e3d1f
diff --git a/docs/release-control/v6/internal/subsystems/cloud-paid.md b/docs/release-control/v6/internal/subsystems/cloud-paid.md
index b60baa9288..3864226242 100644
--- a/docs/release-control/v6/internal/subsystems/cloud-paid.md
+++ b/docs/release-control/v6/internal/subsystems/cloud-paid.md
@@ -3991,3 +3991,20 @@ refused default selection by clearing it and retrying reads, and a user with no
usable organization gets the invitation screen instead of a connection
failure. Hosted tenant selection, subscription gating and paid capabilities
are unchanged.
+
+### Plans & Billing names Pulse MSP for self-hosted installs
+
+`ProLicensePanel.tsx` ends the Plan tab with one line that points operators
+who manage infrastructure for clients at Pulse MSP, a separate self-hosted
+provider bundle sold from `pulserelay.pro/msp`. It changes no plan, licence,
+entitlement or checkout path in this install. The line follows the panel's
+commercial gate, so demo and white-label sessions never render it, and it is
+hidden whenever `isHostedModeEnabled()` is true, which covers Pulse-hosted
+workspaces and every provider MSP client runtime (`PULSE_HOSTED_MODE=true`
+from `internal/cloudcp/docker/manager.go`). It deliberately ignores
+`presentationPolicyHidesUpgradePrompts()`: the server sets that for every free
+install to keep nudges off other pages, while Plans & Billing already shows
+plans to free users who open it. The link carries
+`utm_source=pulse&utm_medium=app&utm_campaign=msp` so website visits that start
+here are counted apart. `ProLicensePanel.test.tsx` pins the free-install
+rendering, the hosted and commercial-hidden absence, and the link attributes.
diff --git a/docs/release-control/v6/internal/subsystems/frontend-primitives.md b/docs/release-control/v6/internal/subsystems/frontend-primitives.md
index c82b1057bd..e955b502ea 100644
--- a/docs/release-control/v6/internal/subsystems/frontend-primitives.md
+++ b/docs/release-control/v6/internal/subsystems/frontend-primitives.md
@@ -11344,3 +11344,13 @@ literal date evidence and the browser-reproduced focus repair. The 15% threshold
all other per-chunk baselines, total JS/CSS and preload/SRI checks stay unchanged.
This is a narrowly declared intentional UI/accessibility cost, not suppression
of the retained failed budget runs or permission to omit browser verification.
+
+### Plans & Billing MSP referral copy stays in the billing presentation owner
+
+The Pulse MSP line at the end of the Plans & Billing Plan tab takes its text
+and button label from `SELF_HOSTED_PRO_BILLING_PRESENTATION`
+(`mspReferralBody`, `mspReferralActionLabel`) and its tagged destination from
+`PULSE_MSP_REFERRAL_URL` in `selfHostedBillingPresentation.ts`, like the rest
+of the billing shell copy. `ProLicensePanel.tsx` renders it with the shared
+`ButtonLink` outline action, which supplies `noopener noreferrer` for the new
+tab; no local link styling or copy is drafted in the panel.
diff --git a/frontend-modern/browser-verification/d7413a97486b67cd.json b/frontend-modern/browser-verification/d7413a97486b67cd.json
new file mode 100644
index 0000000000..d738119a7b
--- /dev/null
+++ b/frontend-modern/browser-verification/d7413a97486b67cd.json
@@ -0,0 +1,42 @@
+{
+ "version": 1,
+ "base_sha": "126fb1fb4e112292ff1d99e48f44c61aafcfc1a1",
+ "verified_at": "2026-11-03T18:14:09Z",
+ "result": "passed",
+ "changed_paths": [
+ "frontend-modern/src/components/Settings/ProLicensePanel.tsx",
+ "frontend-modern/src/components/Settings/selfHostedBillingPresentation.ts"
+ ],
+ "content_sha256": {
+ "frontend-modern/src/components/Settings/ProLicensePanel.tsx": "99745edb730017c5d7baa59c216de712da8cd4a00e42164df9a886a98793b157",
+ "frontend-modern/src/components/Settings/selfHostedBillingPresentation.ts": "c133583f0b661e8b2e632cdd83c19ac0508045dede36b3c581a7c418e5199062"
+ },
+ "routes": [
+ "/settings/system/billing/plan (lands on /settings/pulse-intelligence/billing/plan)"
+ ],
+ "viewports": [
+ {
+ "width": 1440,
+ "height": 900
+ },
+ {
+ "width": 1024,
+ "height": 900
+ },
+ {
+ "width": 375,
+ "height": 812
+ }
+ ],
+ "states": [
+ "production vite build of these exact staged bytes served by vite preview on pulse-dev, proxied to the pulse-perf-rig mock estate on :7699 (a free Community install: /api/security/status reported hideCommercial false and hideUpgrade true), viewed in the desktop app's built-in browser through an SSH tunnel and signed in with the rig's documented dev login",
+ "Plans & Billing, Plan tab: the Pulse MSP line renders once, last in the section, below License recovery, as muted text with an outline 'See Pulse MSP' button; the existing Available plans card, Community status line and recovery block are unchanged above it",
+ "1440 and 1024: text and button side by side in one row (526px by 77px at 1024), no horizontal page overflow (scrollWidth 1429 of 1440 and 1013 of 1024)",
+ "375 phone: text wraps above a full-height button, row inside the panel from x=19 to x=356, scrollWidth 375 of 375",
+ "hosted-mode and demo/white-label absence covered by ProLicensePanel unit tests (no hosted or demo rig was started)"
+ ],
+ "interactions": [
+ "read the rendered line and link from the DOM: href https://pulserelay.pro/msp?utm_source=pulse&utm_medium=app&utm_campaign=msp, target _blank, rel noopener noreferrer",
+ "scrolled the line into view at each width; did not click the link, so no synthetic visit reached the live website funnel"
+ ]
+}
diff --git a/frontend-modern/src/components/Settings/ProLicensePanel.tsx b/frontend-modern/src/components/Settings/ProLicensePanel.tsx
index 170a978181..7a81a4faa8 100644
--- a/frontend-modern/src/components/Settings/ProLicensePanel.tsx
+++ b/frontend-modern/src/components/Settings/ProLicensePanel.tsx
@@ -4,9 +4,13 @@ import { CommercialBillingShell, CommercialSection } from './CommercialBillingSe
import { ProLicensePlanSection } from './ProLicensePlanSection';
import { SelfHostedCommercialRecoverySection } from './SelfHostedCommercialRecoverySection';
import { useProLicensePanelState } from './useProLicensePanelState';
-import { SELF_HOSTED_PRO_BILLING_PRESENTATION } from './selfHostedBillingPresentation';
-import { Button } from '@/components/shared/Button';
+import {
+ PULSE_MSP_REFERRAL_URL,
+ SELF_HOSTED_PRO_BILLING_PRESENTATION,
+} from './selfHostedBillingPresentation';
+import { Button, ButtonLink } from '@/components/shared/Button';
import { Subtabs } from '@/components/shared/Subtabs';
+import { isHostedModeEnabled } from '@/stores/license';
import {
presentationPolicyHidesCommercialSurfaces,
sessionPresentationPolicyResolved,
@@ -118,6 +122,31 @@ const ProLicensePanelContent: Component = () => {
onActivate={state.handleActivate}
onClear={state.handleClear}
/>
+
+ {/* Opening Plans & Billing is the opt-in, so this follows the
+ panel's commercial gate rather than the upgrade-prompt policy
+ that keeps free installs free of nudges elsewhere. Hosted
+ runtimes include MSP client workspaces, which already belong
+ to a provider. */}
+ <Show when={!isHostedModeEnabled()}>
+ <div
+ class="flex flex-col gap-3 border-t border-border pt-4 sm:flex-row sm:items-center sm:justify-between"
+ data-testid="pulse-msp-referral"
+ >
+ <p class="text-sm text-muted">
+ {SELF_HOSTED_PRO_BILLING_PRESENTATION.mspReferralBody}
+ </p>
+ <ButtonLink
+ href={PULSE_MSP_REFERRAL_URL}
+ target="_blank"
+ variant="outline"
+ size="settingsActionXs"
+ class="w-fit shrink-0"
+ >
+ {SELF_HOSTED_PRO_BILLING_PRESENTATION.mspReferralActionLabel}
+ </ButtonLink>
+ </div>
+ </Show>
</div>
</CommercialSection>
</Show>
diff --git a/frontend-modern/src/components/Settings/__tests__/ProLicensePanel.test.tsx b/frontend-modern/src/components/Settings/__tests__/ProLicensePanel.test.tsx
index e3ee655c62..968f5a0903 100644
--- a/frontend-modern/src/components/Settings/__tests__/ProLicensePanel.test.tsx
+++ b/frontend-modern/src/components/Settings/__tests__/ProLicensePanel.test.tsx
@@ -49,6 +49,7 @@ const notificationSuccessMock = vi.fn();
const notificationErrorMock = vi.fn();
const presentationPolicyHidesCommercialSurfacesMock = vi.fn(() => false);
const presentationPolicyHidesUpgradePromptsMock = vi.fn(() => true);
+const isHostedModeEnabledMock = vi.fn(() => false);
const sessionPresentationPolicyResolvedMock = vi.fn(() => true);
const useLocationMock = vi.fn(() => ({
search: '',
@@ -106,6 +107,7 @@ vi.mock('@solidjs/router', async (importOriginal) => {
});
vi.mock('@/stores/license', () => ({
+ isHostedModeEnabled: () => isHostedModeEnabledMock(),
isMultiTenantEnabled: () => true,
loadRuntimeCapabilities: (...args: unknown[]) => loadRuntimeLicenseStatusMock(...args),
}));
@@ -177,6 +179,8 @@ describe('ProLicensePanel', () => {
notificationErrorMock.mockReset();
presentationPolicyHidesCommercialSurfacesMock.mockReset();
presentationPolicyHidesUpgradePromptsMock.mockReset();
+ isHostedModeEnabledMock.mockReset();
+ isHostedModeEnabledMock.mockReturnValue(false);
sessionPresentationPolicyResolvedMock.mockReset();
useLocationMock.mockReset();
navigateMock.mockReset();
@@ -222,6 +226,40 @@ describe('ProLicensePanel', () => {
return within(document.getElementById(SELF_HOSTED_PRO_BILLING_RECOVERY_SECTION_ID)!);
};
+ describe('Pulse MSP referral', () => {
+ it('points free self-hosted installs at Pulse MSP with a tagged link', async () => {
+ // Free installs hide upgrade prompts elsewhere; Plans & Billing is opened on purpose.
+ presentationPolicyHidesUpgradePromptsMock.mockReturnValue(true);
+ renderPanel();
+ const referral = await screen.findByTestId('pulse-msp-referral');
+ expect(referral).toHaveTextContent('Managing infrastructure for clients?');
+ expect(referral).toHaveTextContent('separate self-hosted install');
+ const link = within(referral).getByRole('link', { name: 'See Pulse MSP' });
+ expect(link).toHaveAttribute(
+ 'href',
+ 'https://pulserelay.pro/msp?utm_source=pulse&utm_medium=app&utm_campaign=msp',
+ );
+ expect(link).toHaveAttribute('target', '_blank');
+ expect(link).toHaveAttribute('rel', 'noopener noreferrer');
+ });
+
+ it('stays out of hosted runtimes, which include MSP client workspaces', async () => {
+ isHostedModeEnabledMock.mockReturnValue(true);
+ renderPanel();
+ await waitFor(() =>
+ expect(document.getElementById(SELF_HOSTED_PRO_BILLING_PLAN_SECTION_ID)).not.toBeNull(),
+ );
+ expect(screen.queryByTestId('pulse-msp-referral')).toBeNull();
+ });
+
+ it('is hidden with the rest of the commercial surface in demo and white-label sessions', async () => {
+ presentationPolicyHidesCommercialSurfacesMock.mockReturnValue(true);
+ renderPanel();
+ await screen.findByText('License and billing details are hidden');
+ expect(screen.queryByTestId('pulse-msp-referral')).toBeNull();
+ });
+ });
+
it('replaces an outage with same-key success and genuine refusal beside the recovery controls', async () => {
const outage =
'The license server is temporarily unavailable. Please try again in a few minutes.';
diff --git a/frontend-modern/src/components/Settings/selfHostedBillingPresentation.ts b/frontend-modern/src/components/Settings/selfHostedBillingPresentation.ts
index aaeb738e1a..5a663ac4ef 100644
--- a/frontend-modern/src/components/Settings/selfHostedBillingPresentation.ts
+++ b/frontend-modern/src/components/Settings/selfHostedBillingPresentation.ts
@@ -29,8 +29,15 @@ export interface SelfHostedProBillingPresentation {
purchaseUnavailableActionLabel: string;
recoverySectionTitle: string;
recoverySectionDescription: string;
+ mspReferralBody: string;
+ mspReferralActionLabel: string;
}
+// Pulse MSP is sold from pulserelay.pro, not from this install. The campaign
+// tag keeps visits that start here apart in the website funnel.
+export const PULSE_MSP_REFERRAL_URL =
+ 'https://pulserelay.pro/msp?utm_source=pulse&utm_medium=app&utm_campaign=msp';
+
export const SELF_HOSTED_PRO_BILLING_PRESENTATION: SelfHostedProBillingPresentation = {
navLabel: 'Plans & Billing',
shellTitle: 'Plans & Billing',
@@ -65,4 +72,7 @@ export const SELF_HOSTED_PRO_BILLING_PRESENTATION: SelfHostedProBillingPresentat
purchaseUnavailableActionLabel: 'Try again',
recoverySectionTitle: 'License recovery',
recoverySectionDescription: 'Paste a license key or clear the license on this install.',
+ mspReferralBody:
+ 'Managing infrastructure for clients? Pulse MSP is a separate self-hosted install with an isolated workspace for each client. Evaluate two clients free for 60 days.',
+ mspReferralActionLabel: 'See Pulse MSP',
};