mirror of
https://github.com/rcourtman/Pulse.git
synced 2026-09-22 19:23:31 +00:00
ad00943717
- 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.
2.5 KiB
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:
- Creates a lightweight LXC container
- Installs Pulse inside the container
- 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:
- Installs required dependencies
- Downloads the latest Pulse binary
- Creates a systemd service
- 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