📚 Pulse Documentation

Welcome to the Pulse documentation portal. Here you'll find everything you need to install, configure, and master Pulse.

v6 Execution Canonical Source

For Pulse v6 build/release execution work, do not start from this broad docs index. Use:

docs/release-control/v6/SOURCE_OF_TRUTH.md for stable human governance and locked decisions
docs/release-control/v6/status.json for live lane state, lane-to-subsystem ownership, structured evidence references, typed lane/subsystem decision records, and canonical ordered lists
docs/release-control/v6/status.schema.json for the machine-readable status contract
docs/release-control/v6/subsystems/registry.json and docs/release-control/v6/subsystems/registry.schema.json for subsystem ownership, explicit shared-ownership exceptions, and proof-routing rules
python3 scripts/release_control/status_audit.py --check if you need a machine-derived evidence health audit
python3 scripts/release_control/registry_audit.py --check if you need a machine-derived subsystem registry audit
python3 scripts/release_control/contract_audit.py --check if you need a machine-derived subsystem contract audit, including explicit cross-subsystem dependency checks and exact registry-derived shared-boundary wording Local pre-commit runs the v6 machine audits against staged control-file content so partial staging cannot hide governance drift. Local pre-commit also blocks partial staging for hook-sensitive governance files under docs/release-control/v6/, scripts/release_control/, internal/repoctl/, .husky/pre-commit, and .github/workflows/canonical-governance.yml, because those checks still execute or structurally read the working-tree versions locally.
python3 scripts/release_control/subsystem_lookup.py <path> [<path> ...] if you need subsystem ownership, proof routing, lane context, relevant decision records, and dependent contract-update obligations for a change

For governed runtime changes, a staged subsystem contract only counts if its diff updates a substantive contract section such as Purpose, Canonical Files, Shared Boundaries, Extension Points, Forbidden Paths, Completion Obligations, or Current State, rather than metadata alone.

All other documents are supporting references unless explicitly required for evidence.

🚀 Getting Started

Installation Guide Step-by-step guides for Docker, Kubernetes, and bare metal.
Configuration
Learn how to configure authentication, notifications (Email, Discord, etc.), and system settings.
Deployment Models
Where config lives, how updates work, and what differs per deployment.
Migration Guide
Moving to a new server? Here's how to export and import your data safely.
Upgrade to v6
Practical upgrade guidance and post-upgrade checks for Pulse v6.
FAQ Common questions and quick answers.

🛠️ Deployment & Operations

Docker Guide – Advanced Docker & Compose configurations.
Kubernetes – Helm charts, ingress, and HA setups.
Reverse Proxy – Nginx, Caddy, Traefik, and Cloudflare Tunnel recipes.
Troubleshooting – Deep dive into common issues and logs.

🔐 Security

Security Policy – The core security model (Encryption, Auth, API Scopes).
Privacy – What leaves your network (and what doesn’t).
OIDC / SSO – OIDC Single Sign-On configuration (Authentik, Keycloak, Azure AD, etc.).
Proxy Auth – Authentik/Authelia/Cloudflare proxy authentication configuration.
Agent Security – Agent self-update verification and API security.

📖 Advanced Topics (Relay / Pro / Pro+ / Cloud)

AI Autonomy & Safety – Configure patrol autonomy levels, assistant control levels, investigation tuning, and safety guardrails.
Role-Based Access Control (RBAC) – Define custom roles, assign permissions, and integrate with OIDC group mapping.
Audit Logging – Tamper-evident event logging for compliance, with query, export, and signature verification.

✨ New in 6.0

Unified Resource Model – How all platforms merge into one model with task-based navigation.
Unified Navigation Migration – Upgrading from platform-specific tabs to v6 navigation.
TrueNAS Integration – First-class TrueNAS SCALE/CORE monitoring (pools, datasets, disks, snapshots, replication).
Relay / Mobile Remote Access – End-to-end encrypted relay (mobile app public rollout is coming soon; Relay and above).
Recovery Central – Unified backup, snapshot, and replication view across all providers.
Pulse Cloud (Hosted) – Fully managed hosting with automatic updates and backups.
Pulse AI – Chat assistant, patrol findings, alert analysis, intelligence, and forecasts.
Metrics History – Persistent metrics storage with configurable retention.
Mail Gateway – Proxmox Mail Gateway (PMG) monitoring.
Auto Updates – One-click updates for supported deployments.
Multi-Tenant Organizations – Isolate infrastructure by organization (Enterprise, opt-in).
Entitlements Overhaul – Capability-key-based feature gating across Community/Relay/Pro/Pro+/Cloud.

💳 Plans (Community / Relay / Pro / Pro+ / Cloud)

Pulse is available in four self-hosted tiers plus hosted Cloud:

Community: Free self-hosted monitoring for up to 5 monitored systems with 7-day history.
Relay: Adds remote access, mobile, push notifications, 14-day history, and raises the monitored-system limit to 8.
Pro: Adds AI investigation, auto-fix, operations tooling, and raises the monitored-system limit to 15 with 90-day history.
Pro+: Everything in Pro with room for up to 50 monitored systems.
Cloud: Hosted Pulse with Pro-level capabilities; hosted pricing is unchanged by the self-hosted model lock.
Learn more at pulserelay.pro
Plans and entitlements (includes the Community/Relay/Pro/Pro+/Cloud matrix)
AI deep dive
Multi-Tenant Organizations (Enterprise) — Isolate infrastructure by organization for MSPs and multi-datacenter deployments.

📡 Monitoring & Agents

Unified Agent – Single binary for host, Docker, and Kubernetes monitoring.
Centralized Agent Management (Pro/Pro+/Cloud) – Agent profiles and remote config.
Proxmox Backup Server – PBS integration, direct API vs PVE passthrough, token setup.
TrueNAS – TrueNAS SCALE/CORE integration.
ZFS Monitoring – Proxmox-native ZFS pool monitoring.
Storage Architecture – Proposed canonical storage, disk, S.M.A.R.T., and topology model for making storage genuinely operator-useful.
VM Disk Monitoring – Enabling QEMU Guest Agent for disk stats.
Temperature Monitoring – Agent-based temperature monitoring (pulse-agent --enable-proxmox). Sensor proxy has been removed.
Webhooks – Custom notification payloads.

💻 Development

API Reference – Complete REST API documentation.
Architecture – System design and component interaction.
Contributing – How to contribute to Pulse.

📁 Previous Versions

Upgrade to v5 – Upgrade guidance for v4 → v5 migrations.
v6 Release Promotion Policy – Canonical stable-vs-RC release rules and rollback expectations.
v6 Prerelease Runbook – Internal release operations used during the v6 RC period.

Found a bug or have a suggestion?

8.4 KiB Raw Blame History Unescape Escape