mirror of
https://github.com/rcourtman/Pulse.git
synced 2026-09-11 22:12:23 +00:00
Pulse Monitor
dd5ee8120f
- 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
79 lines
2.1 KiB
Markdown
79 lines
2.1 KiB
Markdown
# FAQ
|
|
|
|
## Installation
|
|
|
|
### What's the easiest way to install?
|
|
```bash
|
|
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](CONFIGURATION.md) 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](PBS-AGENT.md)
|
|
|
|
### 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 |