Files
pulse/docs/INSTALL.md
T
Pulse Monitor ad00943717 feat: major installer improvements for Proxmox environments
- Auto-detects Proxmox VE hosts and creates LXC containers
- Quick mode with sensible defaults (1GB RAM, 4GB disk)
- Advanced mode for full customization
- Automatic cleanup on failure
- Simple 'update' command in containers
- Improved error handling and network detection
- Professional, clean output without verbose noise
- Docker detection to prevent container-in-container
- Removed all references to community scripts

This is now the primary recommended installation method.
2025-08-21 20:43:56 +00:00

2.5 KiB

Installation Guide

Quick Install

The official installer automatically detects your environment and chooses the best installation method:

curl -fsSL https://raw.githubusercontent.com/rcourtman/Pulse/main/install.sh | sudo bash

Installation Methods

Proxmox VE Hosts

When run on a Proxmox VE host, the installer automatically:

  1. Creates a lightweight LXC container
  2. Installs Pulse inside the container
  3. Configures networking and security

Quick Mode (recommended):

  • 1GB RAM, 4GB disk, 2 CPU cores
  • Unprivileged container with firewall
  • Auto-starts with your host
  • Takes about 1 minute

Advanced Mode:

  • Customize all container settings
  • Choose specific network bridges and storage
  • Configure static IP if needed

Standard Linux Systems

On Debian/Ubuntu systems, the installer:

  1. Installs required dependencies
  2. Downloads the latest Pulse binary
  3. Creates a systemd service
  4. Starts Pulse automatically

Docker

For containerized deployments:

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

See Docker Guide for advanced options.

Updating

For LXC Containers

pct exec <container-id> -- update

For Standard Installations

curl -fsSL https://raw.githubusercontent.com/rcourtman/Pulse/main/install.sh | sudo bash

For Docker

docker pull rcourtman/pulse:latest
docker stop pulse
docker rm pulse
docker run -d --name pulse -p 7655:7655 -v pulse_data:/data rcourtman/pulse:latest

Version Management

Install Specific Version

curl -fsSL https://raw.githubusercontent.com/rcourtman/Pulse/main/install.sh | sudo bash -s -- --version v4.6.0

Install Release Candidate

curl -fsSL https://raw.githubusercontent.com/rcourtman/Pulse/main/install.sh | sudo bash -s -- --rc

Troubleshooting

Permission Denied

Make sure to run with sudo on standard Linux systems.

Container Creation Failed

Ensure you have:

  • Available container IDs (check with pct list)
  • Sufficient storage space
  • Network bridge configured

Port Already in Use

Pulse uses port 7655 by default. Check with:

sudo netstat -tlnp | grep 7655

Uninstalling

From LXC Container

pct stop <container-id>
pct destroy <container-id>

From Standard System

sudo systemctl stop pulse
sudo systemctl disable pulse
sudo rm -rf /opt/pulse /etc/pulse
sudo rm /etc/systemd/system/pulse.service

Docker

docker stop pulse
docker rm pulse
docker volume rm pulse_data  # Warning: deletes all data