rcourtman/pulse repository overview

⁠Pulse

Monitoring for Proxmox, Docker, Kubernetes, TrueNAS, and vSphere that watches your infrastructure so you don't have to.

Pulse monitors your whole estate in one workspace and alerts you the moment something breaks. Beyond alerts, Pulse Patrol runs scheduled health checks that catch the problems nobody configured a rule for: backup jobs failing quietly, pools creeping toward full, VMs stuck in restart loops. Notifications via email, Discord, Slack, Telegram, Teams, ntfy.sh, Gotify, and generic webhooks.

Try the live demo →⁠ (read-only with mock data)

⁠Features

• Pulse Patrol (bring your own key): scheduled background health checks, every 10 minutes to every 7 days, that find silent failures and explain what they mean; use your own AI provider or a local model. Pro adds issue investigation and safe, audited fixes.
• Multi-platform: Proxmox VE / PBS / PMG, Docker and Podman (including Swarm services), Kubernetes, TrueNAS, vSphere, and standalone hosts via lightweight agents
• Smart alerts: email and webhooks with adaptive, hysteresis-based thresholds and per-resource overrides
• Auto-discovery: finds Proxmox nodes on your network automatically
• Recovery views: backup, snapshot, and replication history on each platform page
• Chat assistant (bring your own key): ask questions about your infrastructure in natural language
• Bring your own agent (MCP): connect Claude Code, OpenCode, or any MCP client to the same governed Pulse tools the assistant uses (setup under Settings -> Pulse Intelligence -> Assistant -> External agents)
• Metrics history: persistent storage with configurable retention
• Security: credentials encrypted at rest, CSRF protection, rate limiting, bcrypt password hashing, API tokens, and OIDC/SAML/proxy SSO
• Built with Go and SolidJS for minimal resource usage, dark/light themes

⁠Quick Start

docker run -d \
  --name pulse \
  -p 7655:7655 \
  -v pulse_data:/data \
  --restart unless-stopped \
  rcourtman/pulse:latest

Then open http://<your-ip>:7655 and complete the security setup wizard.

⁠Docker Compose

services:
  pulse:
    image: rcourtman/pulse:latest
    container_name: pulse
    ports:
      - "7655:7655"
    volumes:
      - pulse_data:/data
    # environment:
    #   - PULSE_AUTH_USER=admin           # optional: pre-configure auth
    #   - PULSE_AUTH_PASS=your-password   # plain text is auto-hashed
    #   - API_TOKEN=your-token            # optional: for automation
    #   - DISCOVERY_SUBNET=192.168.50.0/24  # optional: non-standard networks
    restart: unless-stopped

volumes:
  pulse_data:

Note for Docker Compose: pre-hashed bcrypt values must escape $ as $$. Plain-text values are hashed automatically and are simpler.

⁠Connect your infrastructure

After logging in, Pulse auto-discovers Proxmox nodes on your network. For Docker, Kubernetes, TrueNAS, vSphere, and standalone hosts, use the install command generated under Settings → Infrastructure → Install on a host.

⁠Image Tags

⁠Plans

Core monitoring is free and full-featured in the Community tier. Optional paid tiers add convenience and operations features: Relay ($39/yr) for secure remote access, mobile app pairing, and push notifications; Pro ($79/yr) for hands-on Patrol modes, issue investigation, verified fixes, and 90-day metric history. Details at pulserelay.pro⁠.

⁠Telemetry and Privacy

Outbound usage telemetry is enabled by default and fully documented⁠. The payload uses a rotating pseudonymous install ID and does not include hostnames, credentials, names, email addresses, IP addresses, or infrastructure identifiers. Disable it any time in Settings or with PULSE_TELEMETRY=false. Your monitoring data itself stays on your server.

⁠Documentation

• Installation Guide⁠
• Docker Monitoring⁠
• Kubernetes⁠
• Configuration⁠
• Upgrade to v6⁠
• Security⁠
• Troubleshooting⁠
• API Reference⁠
• FAQ⁠

⁠Links

• GitHub Repository⁠
• Releases and Changelog⁠
• Issues and Feature Requests⁠
• Live Demo⁠

⁠Support Pulse Development

Pulse is maintained by one person. Sponsorships help cover the demo server, development tools, and domains.

⁠License

MIT. See LICENSE⁠. Use of Pulse Pro is subject to the Terms of Service⁠.