⚠️ CRITICAL: DO NOT AUTO-UPDATE FROM v3.x ⚠️

This is a complete rewrite of Pulse from Python to Go. v3.x users MUST NOT auto-update to v4.x as it will break your installation.

🚀 v4.0.0 - Complete Go Rewrite

This is a complete rewrite of Pulse from Python to Go, bringing significant performance improvements, reduced resource usage, and a modern web interface.

Migration Guide for v3 Users

Please visit https://github.com/rcourtman/Pulse/blob/main/docs/MIGRATION_V3_TO_V4.md for detailed migration instructions.

🐳 Docker Support

Docker images are available for multiple architectures:

• AMD64 (Intel/AMD servers)
• ARM64 (64-bit ARM systems)
• ARMv7 (32-bit ARM, including Raspberry Pi)

Docker Tags

• rcourtman/pulse:latest - Latest stable release (v4.0.0)
• rcourtman/pulse:4, rcourtman/pulse:4.0, rcourtman/pulse:4.0.0 - Version-specific tags
• rcourtman/pulse:v4.0.0 - Full version tag

Docker Installation

# Create data directory
mkdir -p ~/pulse-data

# Run Pulse with Docker
docker run -d \
  --name pulse \
  -p 7655:7655 \
  -v ~/pulse-data:/data \
  --restart unless-stopped \
  rcourtman/pulse:latest

✨ What's New in v4

Complete Architecture Overhaul

• Language: Rewritten from Node.js to Go
• Deployment: Single 13MB binary vs Node.js + 140+ npm packages
• Dependencies: Zero runtime dependencies (vs 140+ npm packages in v3)
• Security: Encrypted credential storage (vs plaintext .env files)

Modern Web Interface

• React-based UI: Fast, responsive, and mobile-friendly
• Real-time updates: WebSocket-based live data
• Dark mode: Built-in theme support
• Mobile optimized: Touch-friendly interface

Enhanced Features

• No node limit: v3 had a bug limiting to 3 nodes, v4 supports unlimited
• Better security: All credentials encrypted at rest
• Single port: Everything on port 7655 (vs multiple services)
• Built-in updates: Auto-update mechanism for v4.x versions

Installation Improvements

• Single binary: 13MB executable includes everything
• No dependencies: No Node.js, npm, or package management required
• No vulnerabilities: Static binary vs npm dependency chain
• Multi-platform: Linux (amd64, arm64, armv7), Docker support

📦 Installation Methods

Direct Download

# Download for your architecture
wget https://github.com/rcourtman/Pulse/releases/download/v4.0.0/pulse-linux-amd64
chmod +x pulse-linux-amd64
./pulse-linux-amd64

Docker

docker run -d -p 7655:7655 -v ~/pulse-data:/data rcourtman/pulse:latest

From Source

git clone https://github.com/rcourtman/Pulse.git
cd Pulse
go build -o pulse cmd/server/main.go
./pulse

🔄 Breaking Changes

• Port change: Default port changed from 3000 to 7655
• Configuration: Web UI only, no more .env files
• Architecture: Complete rewrite, manual migration required
• Node limit fix: v3's 3-node bug resolved in v4

📝 Full Changelog

For a detailed list of all changes, see CHANGELOG.md

🙏 Thank You

Thank you to all Pulse users for your patience during this major rewrite. Your feedback and support have been invaluable in making Pulse better.