mirror of https://github.com/rcourtman/Pulse.git synced 2026-02-19 07:50:43 +01:00

Files

Pulse Monitor dd5ee8120f fix: critical bugs and add .env configuration support

- Fix Export/Import API token authentication (wasn't sending X-API-Token header)
- Add client-side passphrase validation (12+ chars with visual feedback)
- Fix settings persistence for AllowedOrigins field
- Fix hardcoded port display in diagnostics (now shows actual port)
- Add .env file support for non-sensitive configuration (ports, logging, etc)
- Keep sensitive data (API tokens, passwords) using secure methods (systemd env vars)
- Update documentation with configuration guide and latest features
- Document auto-discovery, cluster detection, and export/import features

2025-08-08 22:37:02 +00:00

2.1 KiB

Raw Blame History

FAQ

Installation

What's the easiest way to install?

bash -c "$(wget -qLO - https://github.com/community-scripts/ProxmoxVE/raw/main/ct/pulse.sh)"

System requirements?

1 vCPU, 512MB RAM (1GB recommended), 1GB disk
Network access to Proxmox API

Configuration

How do I add a node?

Auto-discovery (Easiest): Settings → Nodes → Click "Setup Script" on discovered node → Run on Proxmox Manual: Settings → Nodes → Add Node → Enter credentials → Save

How do I change the port?

Edit /etc/pulse/.env, add FRONTEND_PORT=8080, then restart

What permissions needed?

PVE: PVEAuditor minimum
PBS: DatastoreReader minimum

API tokens vs passwords?

API tokens are more secure. Create in Proxmox: Datacenter → Permissions → API Tokens

Where are settings stored?

See Configuration Guide for details

How do I backup my configuration?

Settings → Security → Export Configuration (requires API token or ALLOW_UNPROTECTED_EXPORT=true)

Can Pulse detect Proxmox clusters?

Yes! When you add one cluster node, Pulse automatically discovers and monitors all nodes

Troubleshooting

No data showing?

Check Proxmox API is reachable (port 8006/8007)
Verify credentials
Check logs: journalctl -u pulse -f

Connection refused?

Check port 7655 is open
Verify Pulse is running: systemctl status pulse

Invalid credentials?

Check username includes realm (@pam, @pve)
Verify API token not expired
Confirm user has required permissions

High memory usage?

Reduce metricsRetentionDays in settings and restart

Features

Multiple clusters?

Yes, add multiple nodes in Settings

PBS push mode?

Yes, use PBS agent for isolated servers. See PBS Agent docs

Webhook providers?

Discord, Slack, Gotify, Telegram, ntfy.sh, Teams, generic JSON

Works with reverse proxy?

Yes, ensure WebSocket support is enabled

Updates

How to update?

Docker: Pull latest image, recreate container
Manual: Settings → System → Check for Updates

Will updates break config?

No, configuration is preserved

2.1 KiB Raw Blame History

FAQ