Skip to content

Commit 070751c

Browse files
committed
Update README.md
1 parent 3ac3873 commit 070751c

File tree

1 file changed

+24
-1
lines changed

1 file changed

+24
-1
lines changed

README.md

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -534,8 +534,31 @@ If you find Pulse useful, consider supporting its development:
534534
535535
## ❓ Troubleshooting
536536
537-
Common connection issues:
537+
### Diagnostic Tool
538538
539+
Pulse includes a built-in diagnostic tool to help troubleshoot configuration and connectivity issues:
540+
541+
**Web Interface (Recommended):**
542+
- Click the diagnostics icon (computer monitor) in the header
543+
- Or navigate to `http://your-pulse-host:7655/diagnostics.html`
544+
- The tool will automatically run diagnostics and display:
545+
- Configuration validation
546+
- Connectivity tests
547+
- Permission checks
548+
- Data flow analysis
549+
- Specific recommendations for any issues found
550+
551+
**Command Line:**
552+
```bash
553+
# If using the source code:
554+
./scripts/diagnostics.sh
555+
556+
# The script will generate a detailed report and save it to a timestamped file
557+
```
558+
559+
### Common Issues
560+
561+
* **Empty Backups Tab:** Usually caused by missing `PBS_NODE_NAME` in your configuration. SSH to your PBS server and run `hostname` to find the correct value.
539562
* **Pulse Application Logs:** Check container logs (`docker logs pulse_monitor`) or service logs (`sudo journalctl -u pulse-monitor.service -f`) for errors (401 Unauthorized, 403 Forbidden, connection refused, timeout).
540563
* **`.env` Configuration:** Verify `PROXMOX_HOST`, `PROXMOX_TOKEN_ID`, `PROXMOX_TOKEN_SECRET`, and `PROXMOX_ALLOW_SELF_SIGNED_CERTS`. For PBS, also check `PBS_HOST`, `PBS_TOKEN_ID`, `PBS_TOKEN_SECRET`, `PBS_ALLOW_SELF_SIGNED_CERTS`, and especially **`PBS_NODE_NAME`**. Ensure no placeholder values remain.
541564
* **Network Connectivity:** Can the machine running Pulse reach the PVE/PBS hostnames/IPs and ports (usually 8006 for PVE, 8007 for PBS)? Check firewalls.

0 commit comments

Comments
 (0)