explaingit

rcourtman/pulse

5,663GoAudience · ops devopsComplexity · 3/5LicenseSetup · easy

TLDR

Pulse is a real-time monitoring dashboard for Proxmox, Docker, and Kubernetes that shows all your infrastructure in one browser interface, with threshold alerts and optional AI-powered health analysis.

Mindmap

mindmap
  root((pulse))
    What it does
      Real-time dashboard
      Threshold alerts
      AI health checks
      Backup explorer
    Supported platforms
      Proxmox
      Docker
      Kubernetes
    Notifications
      Discord
      Slack
      Telegram
      Email
    Install options
      One-line script
      Docker run
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Monitor all your Proxmox VMs, Docker containers, and Kubernetes pods from a single browser tab with live metrics.

USE CASE 2

Set up threshold alerts that ping Discord, Slack, or Telegram when a server runs hot or a service goes down.

USE CASE 3

Use the AI health checker to automatically scan your infrastructure and flag silent backup failures or ZFS storage issues every six hours.

USE CASE 4

Browse and visualize your Proxmox backup jobs and storage usage without logging into each host separately.

Tech stack

Go

Getting it running

Difficulty · easy Time to first run · 5min

Requires your own AI provider API key to use the AI health checker and chat features, the real-time dashboard works without one.

Use, modify, and distribute freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Pulse is a monitoring dashboard that brings together real-time status information from several types of infrastructure into a single web interface. It supports Proxmox (a server virtualization platform that runs virtual machines and containers), Docker (a container runtime), and Kubernetes (a system for orchestrating containers across multiple machines). The goal is to give a single view of everything rather than requiring separate tools for each platform. Core features include live metrics for virtual machines, containers, and services, threshold-based alerts that can send notifications through Discord, Slack, Telegram, email, and other services, automatic discovery of Proxmox nodes on the local network, and persistent metrics history with configurable retention. It also includes a backup explorer for visualizing backup jobs and storage usage. Pulse includes two AI-powered features that require you to supply your own API key from an AI provider. A chat assistant lets you ask questions about your infrastructure in plain English. A scheduled health checker called Pulse Patrol runs on a configurable interval (default: every six hours) and generates findings such as ZFS storage pools approaching capacity, backup jobs that silently failed, virtual machines stuck in restart loops, or container health check failures. Installation options include a one-line script that creates a lightweight Linux container directly on a Proxmox host, or a Docker run command for other environments. The dashboard is accessible via a web browser. No telemetry is collected and all data stays on your own server, with credentials encrypted at rest. A paid tier called Pulse Pro adds alert-triggered AI analysis, autonomous auto-fix with an audit trail, PDF and CSV reporting, and SIEM webhook integration. The free tier covers the real-time dashboard, threshold alerts, and both AI features when you supply your own API key. The project is maintained by one developer and is open source under the MIT license.

Copy-paste prompts

Prompt 1
I have a Proxmox server running Docker containers. Help me configure Pulse to monitor both and set up Discord alerts when a container restarts more than 3 times.
Prompt 2
I want to use the Pulse Patrol AI health checker with my own OpenAI API key. Show me the exact config file changes needed to enable it.
Prompt 3
My Pulse dashboard keeps losing connection to one Proxmox node. Here is my current config, help me debug the automatic network discovery settings.
Prompt 4
I want to write a Pulse plugin that tracks my database connection pool usage and displays it on the dashboard. Walk me through the plugin structure in Go.
Prompt 5
Show me how to install Pulse on a non-Proxmox server using the Docker run command and connect it to an existing Docker host.
Open on GitHub → Explain another repo

← rcourtman on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.