A read-only operations view for self-hosted infrastructure.
+Interface · Capabilities · Quick start · Deployment
-Pulse is operationeel **read-only**: het observeert en verklaart, maar start, stopt, verwijdert of repareert geen infrastructuur. Ontbrekende of verouderde telemetrie verschijnt als `Onbekend`, nooit als vals groen. +ITWorx Pulse brings Unraid host, container, storage, network and service telemetry into one operator-focused interface. It helps teams see what needs attention, investigate the underlying resource, and keep dashboards, alerts, incidents and wallboards in the same context. -Actuele release: **v1.5.0**. +Current release: **v1.6.0**. See the [changelog](CHANGELOG.md) for release history. -## Wat je als gebruiker krijgt +Pulse is operationally **read-only**: it observes and explains infrastructure, but does not start, stop, delete or repair workloads. Missing or stale telemetry appears as **Unknown**, never as a reassuring green status. -- een overzicht dat meteen toont wat gezond, gedegradeerd, kritisch of onbekend is en waarom; -- detailpagina's voor host, processen, containers, applicaties, array, disks, pools, shares, services en netwerk; -- versieerbare dashboards met afzonderlijke desktop-, tablet-, mobiele en wallboardlayouts; -- begrensde historische en live Prometheus-query's zonder dat gebruikers zelf PromQL moeten schrijven; -- alerts met pending/recovery, hysterese, suppressie, silences en maintenance; -- incidentgroepering, tijdlijnen, notities, ownership en audit; -- Authentik/OIDC-login met viewer-, operator-, editor- en administratorrollen; -- controleerbare backups en een clean-room herstelprocedure; -- hardened non-root containers en een minimale read-only collectorgrens. +## See Pulse in action -## Platform in één oogopslag + -```text -Browser - └─ HTTPS / OIDC / REST / WebSocket - └─ Pulse Web + API - ├─ PostgreSQL configuratie, inventory, dashboards, alerts en audit - ├─ Prometheus begrensde historische en live metrics - ├─ Pulse Worker discovery, probes, alerting en notifications - └─ Pulse Agent minimale read-only Unraid- en hostobservatie -``` +*This capture uses isolated validation fixtures and does not show a production host.* -De web/API-laag krijgt geen Docker-socket of host-roottoegang. Alleen de agent ontvangt de expliciet geconfigureerde read-only bronnen die nodig zijn voor observatie. +## Capabilities -## Snel lokaal proberen +| Area | What operators can do | +| --- | --- | +| Overview and search | Move from an attention item to the exact host, container, service or storage resource. | +| Infrastructure detail | Inspect hosts, processes, containers, applications, arrays, disks, pools, shares and networks. | +| Dashboards | Compose versioned desktop, tablet, mobile and wallboard layouts. | +| Metrics | Explore bounded historical and live Prometheus queries without writing PromQL. | +| Alerts and incidents | Manage pending and recovery states, suppression, maintenance, timelines, notes and ownership. | +| Access and recovery | Use Authentik/OIDC roles, audit trails, verifiable backups and clean-room restore procedures. | -Vereisten: Go 1.26.6, Node.js 24+, pnpm 10.33+, Python 3, PowerShell 7 en Docker Compose. +The global operator bar keeps time context, entity search, favorites, saved views and recent resources available while investigating. The interface supports responsive layouts and accessible keyboard navigation. + +## Try it locally + +Requirements: Go 1.26.6, Node.js 24+, pnpm 10.33+, Python 3, PowerShell 7 and Docker Compose. ```powershell Copy-Item .env.example .env @@ -42,51 +39,39 @@ pwsh -NoProfile -File scripts/bootstrap.ps1 docker compose -f deploy/compose.yaml -f deploy/compose.dev.yaml up --build ``` -Open daarna `http://localhost:18080`. De ontwikkelstack gebruikt expliciete mock-authenticatie en geïsoleerde lokale data; gebruik hiervoor nooit productiecredentials of productiedata. +Open{copy.alerts.operations}
{copy.alerts.operationsIntro}
+ {state === 'loading' ?{copy.alerts.operationsLoading}
: state === 'error' ?{copy.alerts.operationsError}
: visible.length === 0 ?{copy.alerts.noActiveAlerts}
:{copy.alerts.editor}
Snel starten
De template vult alleen de regelconfiguratie in. Controleer metric, scope en drempels vóór opslaan.
{message}
} -{copy.alerts.preview}
{copy.alerts.previewDetail}
{preview &&{presentStatus(preview.state)}: {presentReason(preview.reason)}
}{copy.alerts.preview}
{copy.alerts.previewDetail}
{preview &&{copy.overview.services}
{servicesUsable ? boundedRatio(availableServices, overview.serviceTotal, overview.servicesPartial) : '—'}{overview.resources.services !== 'ready' ? signalResourceLabel(overview.resources.services, serviceTone) : !serviceConfigured ? copy.overview.signalPathNotConfigured : overview.servicesPartial ? copy.overview.signalPathPartial : copy.overview.available}{copy.overview.actionQueue}
{resourcesLoading ? copy.overview.loadingResources : copy.overview.noProblems}
}{copy.overview.actionQueue}
{resourcesLoading ? copy.overview.loadingResources : copy.overview.noProblems}
}{copy.overview.storagePools}
{resourceStateDetail(overview.resources.pools)}
: poolSourceTone !== 'healthy' ?{copy.overview.resourceStaleDetail}
: overview.pools.length ?{copy.overview.noPools}
}{copy.overview.storagePools}
{resourceStateDetail(overview.resources.pools)}
: poolSourceTone !== 'healthy' ?{copy.overview.resourceStaleDetail}
: overview.pools.length ?{copy.overview.noPools}
}Nu
{overview.resources.containers !== 'ready' ? resourceStateDetail(overview.resources.containers) : containerSourceTone !== 'healthy' ? copy.overview.resourceStaleDetail : overview.containersPartial ? copy.overview.resourcePartialDetail : overview.containerTotal > 0 ? `${runningContainers} van ${overview.containerTotal} ${copy.overview.containersRunning}.` : copy.overview.signalPathNoWorkloads}
{copy.overview.recentIncidents}
{resourceStateDetail(overview.resources.incidents)}
: orderedIncidents.length ?{copy.overview.noIncidents}
}{copy.overview.recentIncidents}
{resourceStateDetail(overview.resources.incidents)}
: orderedIncidents.length ?{copy.overview.noIncidents}
}{copy.dashboards.widgetError}
{copy.dashboards.widgetErrorDetail}
{copy.dashboards.viewMode}
{wallboard ?{summary.description || copy.dashboards.noDescription}
{copy.dashboards.clearFilterHint}
{copy.dashboards.viewMode}
{wallboard ?{summary.description || copy.dashboards.noDescription}
{copy.dashboards.clearFilterHint}
{copy.settings.current}
{copy.settings.management}
{group.detail}
Workload context
Voor deze applicatie zijn geen componentrelaties aangeleverd.
:{item.id}{copy.applications.detailEyebrow}
{copy.applications.detailIntro}
{copy.applications.source}
{presentReason(reason.code)}
)}{copy.applications.detailEyebrow}
{copy.applications.detailIntro}
Status
{app.status}{app.overridden ? copy.applications.overridden : copy.applications.discovered}Componenten
{app.components.length}{app.components.filter((item) => item.critical).length} kritischContainers
{app.components.filter((item) => item.kind.toLowerCase().includes('container')).length}Direct navigeerbaarServices
{app.components.filter((item) => item.kind.toLowerCase().includes('service') || item.kind.toLowerCase().includes('probe') || item.kind.toLowerCase().includes('endpoint')).length}Healthcontext{copy.applications.source}
{presentReason(reason.code)}
)}{copy.applications.eyebrow}
{copy.applications.intro}
{copy.applications.source}
{snapshot.total} {copy.applications.rows}
{copy.applications.list}
{copy.applications.empty}
:{shell.eyebrow}
{shell.intro}
{dirty &&{shell.dirty}
}{message}
}{group.label}
{message}
}{labels[widget.type] ?? widgetTypeCopy.fallback}
{cardCopy.resizeHint}
{Object.keys(errors).length > 0 &&{cardCopy.incompleteConfig}
}{locked ? cardCopy.lockedHint : cardCopy.dragHint}
{labels[widget.type] ?? widgetTypeCopy.fallback}
{cardCopy.resizeHint}
{Object.keys(errors).length > 0 &&{cardCopy.incompleteConfig}
}{locked ? cardCopy.lockedHint : cardCopy.dragHint}